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Overview 


About This Manual 


The DYNIX/ptx Reference Manual is for programmers working in the 
DYNIX/ptx operating system environment. This manual describes the 
programming features of the operating system and assumes that the 
audience is familiar with the operating system. It does not provide a general 
overview of the operating system or implementation details of the system. 


The DYNIX/ptx Reference Manual is contained in five binders organized as 


Commands 
Commands 
System Calls 


Sequent System Calls 
Subroutines 


Section 3C C Library Routines 

Section 3M Mathematical Library Routines 

Section 3N Networking Support Utilities 

Section 3PPS Sequent Parallel Programming Library 
Section 3S Standard I/O Library Routines 

Section 3SEQ Sequent I/O Library Routines 

Section 3X Special Routines 


Organization 
follows: 
e Section 1 A-F 
¢ Section 1 G-Z 
¢ Section 2 
Section 2SEQ 
Section 3 
¢ Section 4 
Section 5 
¢ Section 7 
Section 8 


File Formats 
Miscellaneous Facilities 


Special Files 
Stand-alone Utilities 
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Each binder also contains the following items: 


¢ Table of Contents that alphabetically lists the contents of the entire 
manual set 


¢ Permuted Index that lists each programming feature in the entire 
manual set 


The permuted index is a list of keywords, given alphabetically in the second 
of three columns, together with the context in which each keyword is found. 
The following shows four separate entries illustrating four ways that the cat 
command can be looked up in the permuted index. Note that you can find the 
cat command by looking up “cat,” “concatenate,” “files,” or “print.” 


cat: concatenate and print files.. ..cat (1) 

cat: concatenate and print files. cat (1) 

concatenate and print files....... 2c cee eee eee e eens ..cat (1) 
concatenate and print files + cat (1) 


Keywords are either topical keywords or the names of manual entries 
themselves. Entries are identified with their section numbers shown in 
parentheses. The numbers are important because there is duplication of 
names among the sections. The right column lists the name of the manual 
page on which each keyword may be found. The left column contains useful 
information about the keyword. 


The following paragraphs briefly describe the other sections of the manual. 


Section 1: Commands describes operating system commands and 
commands that support C and other programming languages. 


Section 2: System Calls describes the access to the services provided by the 
operating system kernel, including the C language interface. 


Section 2SEQ: Sequent System Calls describes the access to the Sequent 
services provided by the operating system kernel, including the C language 
interface. 


Section 3: Subroutines describes the available subroutines. Their binary 
versions reside in various system libraries in the directories /lib and 
/usr/lib. The introduction to Section 3 describes these libraries and the files 


in which they are stored. 
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Section 4: File Formats documents the structure of particular kinds of 
files; for example, the format of the output of the link editor is given in 
a.out(4). Excluded are files used by only one command (for example, the 
assembler’s intermediate files). In general, the C language structures 
corresponding to these formats can be found in the directories /usr/include 
and /usr/include/sys. 


Section 5: Miscellaneous Facilities contains a variety of descriptions 
including descriptions of character sets, macro packages, and so forth. 


Section 7: Special Files describes various special files that refer to specific 
hardware peripherals and operating system device drivers. 


Section 8: Stand-alone Utilities describes stand-alone procedures, 


References to manual pages with numbers other than those above mean that 
the utility is contained in the appropriate section of another manual. Each 
section consists of independent entries which are alphabetized, with the 
exception of the introductions that begin some sections. Section 3 is divided 
into subsections in alphabetical order by suffix. Some entries may describe 
several routines, commands, and so forth. In such cases, the entry appears 
only once, alphabetized under its primary name, the name that appears at 
the upper corners of each manual page. 


- Each manual page can be viewed online with the man(1) command. For 


example, enter man shell to view the shell manual page. Enter man man 
for more information about the man command. 


Notational Conventions 


Manual pages are based on a common format. The main headings are 
described here—not all of them appear in all cases: 


¢ NAME gives the name(s) of the entry and briefly states its purpose. 
This entry is used to create the Permuted Index and the Table of 
Contents. 


¢ SYNOPSIS summarizes the usage of the program being described. 
Conventions vary in some sections but are generally as follows: 
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¢ Boldface strings are literals and are to be typed just as they 
appear. 


e Italic strings usually represent substitutable argument prototypes 
and program names found elsewhere in the manual. 


¢ Square brackets [] around an argument prototype indicate that 
the argument is optional. When an argument prototype is given 
as name or file, it refers to a filename. 

¢ Ellipses ... are used to show that the previous argument 
prototype may be repeated. 

¢ A final convention is used by the commands themselves. An 
argument beginning with a minus -, plus +, or equal sign = is often 
taken to be some sort of flag argument even if it appears in a 
position where a file name could appear. Therefore, it is unwise to 
have files whose names begin with -, +, or =. 


¢ CONFIGURATION ENTRY shows how a driver is called out in a system 
configuration file. 


¢ DESCRIPTION describes the entry, including its purpose and how it is 
used. 


¢ FIELDS describe system file or record entries. 
¢ EXAMPLES and BINARY CONFIGURATION give examples of usage. 


¢ FILES list files that are part of a program, created by a program, or 
related to a program. 


¢ SEE ALSO points to related information in other manual pages. 


¢ DIAGNOSTICS discuss the diagnostic (error) messages that may be 
produced. Messages that are self-explanatory are not listed. 


° WARNINGS contains warnings against improper user actions. 
¢ NOTES give hints about the use of the utility. 
¢ BUGS describe known bugs in the software. 
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Contents 


INtrO(1) ....essecceserees suseaspanbacsansosousastibscnsess introduction to maintenance commands and 

application programs 

handle special functions of DAS] 300 and 300s terminals 
. paginator for the Tektronix 4014 terminal 


450(1) ..... . handle special functions of the DASI 450 terminal 
accept(1M): accept, reject . allow or prevent LP requests 
acct(1M): acctdisk, acctdusg, accton, 
ACCEWEMP sressessseees wiseassosenssdvesoxecescspsesvors overview of accounting and miscellaneous 
accounting commands 
acctems(1M) ......s00 oasutbevanddssonetones sss COMmand summary from per-process accounting records 
BCCECOM(L) ...seseesssessenererenen cosstedastacsicenes ... Search and print process accounting files 
acctcon(1M): acctcon], acctco: . connect-time accounting 
ACCEL (1M)  -ssesssssssssesseseseseeees . merge or add total accounting files 


acctpre(1M): acctprel, acctpre2_..... 
acctsh(1M): chargefee, ckpacct, 
dodisk, lastlogin, monacct, 

nulladm, pretmp, prdaily, prtacct, 
shutacct, startup, turnacct 


.. process accounting 


. shell procedures for accounting 


addcmdopt(1M) ... add a command option to a menu 
addformopt(1M) add a form/SELECT window option to a menu 
addmenuopt(1M) . . add a menu option to a menu 

admin(1) ..... create and administer SCCS files 


apropos(1) . locate commands by keyword lookup 
ar(1) . . see C and Language Tools Binder 

as(1) . . see C and Language Tools Binder 

asa(1) ... . interpret ASA carriage control characters 


assist(1) 
astgen(1) 


. assistance using operating system commands 

. program for generating/modifying ASSIST menus or 
command forms 

execute commands at a later time 

. pattern scanning and processing language 

. make posters 

. deliver portions of pathnames 

. arbitrary-precision arithmetic language 

. system initialization procedures 


at(1): at, batch 


bdflush(1M) . update daemon 

bdiff(1) . . big diff 

bfs(1) .... . big file scanner 

bomverify(1M) .. . perform an installation consistency check based on 
the BOM 

bootflags(1M) 

bp(1M) . 

cal(1) .... . print calendar 
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calendar(]) .... .. reminder service 

captoinfo(1M) convert a termcap description into a terminfo description 
cat(1) .. concatenate and print files 

cb(1) see C and Language Tools Binder 

ec(1) see C and Language Tools Binder 

ed(1) change working directory 


ede{1) .. change the delta commentary of an SCCS delta 
cflow(1) see C and Language Tools Binder 

checkeq(1) .. check documents for correct eqn syntax. 
checkfsye(1M) check a filesystem 

Chmod(1)  ...cssseres change mode 

chown(1): chown, chgrp . change owner or group 

chroot(1M) .... change root directory for a command 
chrtbl(1M) generate character classification and conversion tables 
CHL) seaseseseeee check in RCS revisions 

ckbupscd(1M) check filesystem backup schedule 

clri(1M) ... clear inode 

emp(1) ‘compare two files 

CO) asia check out RCS revisions 

col(1) ... filter reverse line-feeds 

comb(1) combine SCCS deltas 

comm(1) .. .. select or reject lines common to two sorted files 


compress(1): compress, 
uncompress, zcat .. 
config(1M) 
coproc(1F): cocreate, cosend, 

cocheck, coreceive, codestroy . 


.. compress and expand data 
.. build system configuration files 


.. communicate to a process 


cp(1): cp, In, mv ... ... copy, link or move files 

cpp(1) .. .. see C and Language Tools Binder 
cpio(1) . . copy file archives in and out 
cpre(1) .. Bee C and Language Tools Binder 


.. copy file and set mode, user, and group IDs 
.. examine system images 
clock daemon 


cpset(1) ... 
crash(1M) 
cron(1M) . 


crontab(1) user crontab file 

crypt(1) ... encode/decode 

esh(1) .. a shell (command interpreter) with C-like syntax 
esplit(1) context split 

ct(1C) .. spawn getty to a remote terminal 
ctags(1) .... create a tags file 

ctrace(1) see C and Language Tools Binder 

cu(1C) .. call another UNIX system 

cut(1) ... cut out selected fields of each line of a file 
exref(1) see C and Language Tools Binder 

date(1) . print and set the date 

dbx(1) see C and Language Tools Binder 

de(1) ..... desk calculator 

dcheck(1M) filesystem directory consistency check 
dd(1M) .. convert and copy a file 

delta(1) ... .. make a delta (change) to an SCCS file 
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ETONGE) settscactorrecesceseeseesseahcetae ca insessiose remove nroff, tbl, and eqn constructs 
devbuild(1M): devbuild, 
devdestroy ... build and destroy virtual devices 


. device name 

. report number of free disk blocks and inodes 
. differential file comparison 

. 3-way differential file comparison 

. directory comparison 

. see C and Language Tools Binder 

. generate disk accounting data by user ID 

. refresh security table 

. collect system diagnostic messages to form error log 
Sates summarize disk usage 

. see C and Language Tools Binder 

. incremental filesystem dump 

. dump kernel auto-configuration device table 


devnm(1M) 


dumpfs(1M) . . dump filesystem information 
ec(1M) ... . forms compiler 
echo(1) .. . echo arguments 
echo(1F) ... . put string on virtual output 


ed(1): ed, red . text editor 


edc(1M) .... . run an externally described command 
edit(1) ....... . text editor (variant of ex for casual users) 
edquota(1M) . edit user quotas 

(3 i(6 > eee . Extended Fortran Language 

egrep(1) . search a file for a pattern using full regular expressions 
enable(1): enable, disable . enable/disable LP printers 

env(1) . 8et environment for command execution 
ex(1) ... . text editor 

expr(1) . evaluate arguments as an expression 
factor(1) . obtain the prime factors of a number 
fK1M) .... . list filenames and statistics for a filesystem 
fgrep(1) . search a file for a character string 

file(1) . determine file type 


format( 1M)  ..essssrssssscscsssscsssssesssessssssseesaes format disks or perform other defect management 
functions 

filesystem consistency check and interactive repair 
. install random inode generation numbers 

. split {77, ratfor, or efi files 

. report filesystem status 

determine filesystem identifier 

identify processes using a file or file structure 

. manipulate connect accounting records 


fck(1M) 


fwtmp(1M): fwtmp, wtmpfix ... 
gdev(1G): hpd, erase, hardcopy, 
tekset, td .. graphical device routines and filters 
. graphical editor 

. create a front-end to the cc command 
. get a version of an SCCS file 

. returns the current frame number 
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getitems(1F) ea bbaaecedcessas ... Feturns a list of the currently marked menu items 
getopt(1) .... ee .. parse command options 

getopts(1): getopts, getoptcvt parse command options 

getty(1M) .... set terminal type, modes, speed, and line discipline 


glossary(1) definitions of common operating system terms and 
symbols 

graph(1G) .. draw a graph 

graphics(1G) access graphical and numerical commands 


select terminal filter 
search a file for a pattern 


groups(1) show group memberships 

gutil(1G) ... .. graphical utilities 

help(1) ...... .. operating system Help Facility 

helpadm(1M) change the Help Facility database 

hp(1) ....... handle special functions of Hewlett-Packard terminals 

Hpio(1) ...rsevees Hewlett-Packard 2645A terminal tape file archiver 

icheck(1M) filesystem storage consistency check 

id(1M) ..... ‘print user and group IDs and names 

ident(1) .. .. identify files 

indicator(1F) .... .. display application specific alarms and/or the 
working indicator 

infocmp(1M)  ..essecesesees compare or print out terminfo descriptions 

init(1M): init, telinit . .. process control initialization 

install(1M) ..... .. install commands 

installboot(1M) .. installs a boot program on a disk 

{pcrm(1) ssw .. remove a message queue, semaphore set, or shared 
memory ID 

Ipca(1) sree .. Teport inter-process communication facilities status 

isismgr(1M) . .. ISIS file manager, updates text files in ISIS file format 

join(1) .... relational database operator 

kill(1) .. .. terminate a process 


killall(1M) . kill all active processes ' 

ksh(1): ksh, rksh... .. the KornShell, a standard/restricted command and 
programming language 

labelit(1M) . provide labels for filesystems 

1d(1) ... see C and Language Tools Binder 


Tex(1) ... . generate programs for simple lexical tasks 
line(1) .. . read one line 

link(1M): . link and unlink files and directories 

lint(1) .. see C and Language Tools Binder 

list(1) .. . see C and Language Tools Binder 

locate(1) . use keywords to identify an operating system command 
login(1) ... sign on 

logname(1) . get login name 

lorder{1) .... . see C and Language Tools Binder 

Ip(1): Ip, cancel . send/cancel requests to the LP print service 
Ipadmin(1M) . . configure the LP print service 

Ipfilter(1M) . administer filters used with the LP print service 
Ipforms(1M) . administer forms used with the LP print service 
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Ipsched(1M): Ipsched, Ipshut, 
Ipmove 
Ipstat(1) ..... 


start/stop the LP print service and move requests 

.. print information about the status of the LP print service 
.. Set printing queue priorities 

.- list contents of directory 

-» macro processor 


usb, UBb2, uSbS, vas vax . 
mail(1): mail, rmail 


.. get processor type truth value 
.. send mail to users or read mail 


mailbug(1) submit a bug report or enhancement request 
mailx(1) .. interactive message processing system 
make(1) .. .. maintain, update, and regenerate groups of programs 
makealiases(1M): makealiases, 

makewhatis ... generate man page databases 
makedev(1M) make system special files 

makekey(1) generate encryption key 

man(1) ....... display on-line man pages 

mcs(1) os manipulate the object file comment section 
menu(1M) . menu processor 

menumsg(1M) route user message to menu message queue 
merge(1) .. three-way file merge 

mesg(1) ... .. permit or deny messages 

message(1F) puts its arguments on message line 
mkdir(1) .... make directories 

mkfs(1M) ... ..» construct a filesystem 

mknod(1M) ... . build special file 

mkpwdbm(1M) . make a database for fast password lookup 
mkvtoc(1M) ....... . populate VTOC on disks 

monitor(1M) . . monitor system activity 

MOTE(L) cressveees . View a file one full screen at a time 


mount(1M): mount, umount . mount and unmount filesystems 


mountall(1M): mountall, 


umountall . mount, unmount multiple filesystems 
mt(1) ws magnetic tape manipulating program 
mvdir(1M) move a directory 

nawk(1) pattern scanning and processing language 
ncheck(1M) . generate pathnames from i-numbers 
newform(1) change the format of a text file 

newfs(1M) ... construct a new file system 

newgrp(1M) log in to a new group 

newa(]) .... . print news items 


nice(1) run a command at low priority 

ni(1) . . line numbering filter 

nm(1) .... . see C and Language Tools Binder 

noage(1M): noage, nopff, noswap, 

ONPTOC sesssssssees si isvinswipasasnsinicivctacsusceseussasie run a command with priority aging, PFF, swapping, 


or processor migration disabled 
. run a command immune to hangups and quits 
. octal dump 


online(1M): online, offline . bring processors online and offline 
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... compress and expand files 


pack(1): pack, peat, unpack 


passmgmt(1M) ... password files management 

passwd(1) . change login password and password attributes 

paste(1) .... .. Merge same lines of several files or subsequent lines 
of one file 

pathconv(1F) . search Interpreter criteria for filename 


see C and Language Tools Binder 

file perusal filter for CRTs 

display or alter parameters of virtual-to-physical 
mapping devices 

.. print files 

display profile data 

prompt program 

print an SCCS file 

print the VTOC of a block device 

.. report process status 

.. password/group file checkers 

.. installs and updates /etc/shadow with information 
from /etc/passwd 

. working directory name 

daemon to oversee password database creation 
remove incorrectly formatted password entries 

.. converts from a two to a one password file scheme 
.. display disk usage and limits 

.. filesystem quota consistency checker 

.. turn filesystem quotas on and off 

.. rational Fortran dialect 


QUOtACL) ccesssssssesees 
quotacheck(1M) 
quotaon(1M): quotaon, quotaoff 
ratfor(1) .... 


rc0(1M) ... run commands performed to stop the operating system 
re2(1M) .. run commands performed for multi-user environment 
rea(1) ... .. change RCS file attributes 

resdiff{1) ... .. compare RCS revisions 

resintro(1) .. introduction to RCS commands 

resmerge(1) ... .. merge RCS revisions 

readfile(1F): readfile, longline .. reads file and gets longest line 

regemp(1) . .. regular expression compile 

regex(1F) ... .. match patterns against a string 


.. Tun an initialization file 
.. Summarize quotas for a filesystem 
.. reset the current form field to its default values 


restore(1M) .. incremental filesystem restore 

TIOG( 1) seesssseees .. print log messages and other information about RCS files 
‘rm(1): rm, rmdir . remove files or directories 

rmdel(1) .. remove a delta from an SCCS file 

rmvopt(1M) remove a menu option 

run(1F) ....... run an executable 

runacct(1M) run daily accounting 

sact(1) print current SCCS file editing activity 


system activity graph 
system activity reporter 


sar(1M): sal, a2, sadc ..... . system activity report package 
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savecore(1M) ... 


.. Save a core dump of the operating system 


secsdiff{1) .. compare two versions of an SCCS file 

sccstores(1) build RCS file from SCCS file 

sdiff(1) ... side-by-side difference program 

sed(1) .. stream editor 

set(1F): set, unset . set and unset environment variables in core or in files 

setcolor(1F) .. redefine or create a color 

setmnt(1M) establish mount table 

setpgrp(1) .. .. Tun command in its own process group 

setup(1) . .. initialize system for first user 

sh(1): sh, rsh. .. Shell, the standard/restricted command 
programming language 

shell(1F) ....... run a command using shell 

showcfg(1M) .. show the configuration of the machine 

shutdown(1M) . shut down system, change system state 

size(1) .... .. see C and Language Tools Binder 


sleep(1) .. suspend execution for an interval 

sort(1) .... .. sort and/or merge files , 

spell(1): spell, hashmake, spellin, 

hashcheck . saeesee ..... find spelling errors 

spline(1G) . interpolate smooth curve 

split(1) ... split a file into pieces 

starter(1) ... .. information about the operating system for 
beginning users 

stat(1G) ..... . statistical network useful with graphical commands 

strace(1M) . print STREAMS trace messages 

strclean(1M) STREAMS error logger cleanup program 

strerr(1M) . ... STREAMS error logger daemon 

strip(1) .. see C and Language Tools Binder 

stty(1) set the options for a terminal 

su(1M) become superuser or another user 

sum(1) ... print checksum and block count of a file 

swap(1M) swap administrative interface 

sweepon(1M): sweepon, sweepoff .. enable/disable patrol seeks on DCC disks 

sync(1M) update the superblock 

sysadm(1) . menu interface to do system administration 


set tabs on a terminal 

.. deliver the last part of a file 

.. tape file archiver 

create security table in shared memory 

pipe fitting 

condition evaluation command 

interprocess communication reporter 

assign menu system as user login shell 

send completion message 

terminfo compiler 

time(1): time, ptime time a command 

timex(1) ...scsccsesececseeneen time a command; report process data and system activity 
toc(1G): dtoc, ttoc, vtoc ... graphical table of contents routines 

touch(1) ...... asesb Scie baseensscosassisionsescasesoies update access and modification times of a file 


tasktbl(1M) 
tee(1) ..... 
test(1) 
tfipe(1M) 
tfmenush(1M) 
tfnotify(1M) . 
tic(1M) 
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.. graphics filters @ 


initialize a terminal or query terminfo database 
translate characters 

provide truth values 

topological sort 

.. get the name of the terminal 

get the device associated with a terminal or the 
terminal associated with a device 

ANS LACE): erssssescscscnssocdnsesccnsssdsncsvesedeanes tune up an existing filesystem 


tplot(1G) . 
tput(1) . 
tr(l) . 
true(1): true, false 
tsort(1) 
tty(1) 


ttydevname(1) 


uadmin(1M) .. administrative control 

umask(1) set file-creation mode mask 
uname(1) .. print name of current system 
unget(1) .. .. undo a previous get of an SCCS file 
uniq(1) . report repeated lines in a file 
units(1) ... .. conversion program 

uptime(1) .. show how long system has been up 


retrieve a command description and usage examples 
‘check the uucp directories and permissions file 

file transport program for the uucp system 

uucp spool directory clean-up 

UNIX-to-UNIX system copy 

set terminal type, modes, speed, and line discipline 
the scheduler for the uucp file transport program 
uucp status inquiry and job control 

public UNIX-to-UNIX system file copy 

try to contact remote system with debugging on 
UNIX-to-UNIX system command execution 


usage(1) .. 
uucheck(1M) . 
uucico(1M) ..... 
uucleanup(1M) . 
uucp(1C): uucp, uulog, uuname 
uugetty(1M) 
uusched(1M) 
uustat(1C) ..... 
uuto(1C): uuto, uupick . 
uutry(1M) ... 
uux(1C) .. 


uuxqt(1M) execute remote command requests 

val(1) ... validate SCCS file 

ve(1) version control 

VIC1) eee screen-oriented (visual) display editor based on ex 

vmtune(1M) tune system-wide virtual-memory parameters 

volcopy(1M) make literal copy of filesystem 

vsig(1F) .. synchronize a co-process with the controlling FMLI object 

wait(1) . await completion of process 

wall(1) . write to all users 

we(1) .... .. word count 

what(1) .... .. identify SCCS files 

whatis(1) . describe what a command is 

who(1) .. who is on the system 

whodo(1M) . .. who is doing what 

write(1) ... write to another user 

xargs(1) ... .. construct argument list(s) and execute command 
ACH) sresssssssnsneneen eaaesesiatenses pivehenseseaceassxs yet another compiler-compiler 
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2 System Calls 

intro(2) ... introduction to system calls and error numbers 
access(2) .. determine accessibility of a file 

acct(2) . . enable or disable process accounting 


alarm(2) .. . set a process alarm clock 

brk(2): brk, sbrk . . change data segment space allocation 
chdir{2) .... change working directory 

chmod(2) . change mode of file 

chown(2) . . change owner and group of a file 

chroot(2) . . change root directory 

close(2) close a file descriptor 

creat(2) . create a new file or rewrite an existing one 
dup(2) . . duplicate an open file descriptor 

dup2(2) ... duplicate an open file descriptor 


exec(2): execl, execv, execle, 
execve, execlp, execvp ... 
exit(2): exit, exit 
fentl(2) 
fork(2) .. 


. execute a file 

. terminate process 

. file contro] 

. create a new process 


getdents(2) . . read directory entries and put in a file system 
independent format 

getgroups(2) sseseee Bet supplementary group IDs 

getmsg(2) ... sss Bet next message off a stream 


getpid(2): getpid, getpgrp, getppid .... get process, process group, and parent process IDs 
getuid(2): getuid, geteuid, getgid, 


getegid «0. asnddbasnsdasnbscbutescsasiesnsies asses get real user, effective user, real group, and effective 
group IDs 

ioctl(2) : 

kill(2) .. 

link(2) .. 

lseek(2) 

mkdir(2) . e 

mknod(2): mknod . make a directory, or a special or ordinary file 

mount(2) .... . mount a filesystem 

msgctl(2) . Message control operations 

msgget(2) . get message queue 

msgop(2) . . message operations 

nice(2) .. . change priority of a process 

open(2) ... . open for reading or writing 

pathconf{2): pathconf, fpathconf ........ get configurable pathname variables 

pause(2) .. . suspend process until signal 

pipe(2) create an interprocess channel 

plock(2) . lock process, text, or data in memory 

poll(2) . . STREAMS input/output multiplexing 

profil(2) ... . execution time profile 

ptrace(2): ptrace, mptrace . process trace facility 

putmsg(2) . send a message on a stream 

read(2) .... . read from file 

rename(2) change the name of a file 

rnndir{2) .. remove a directory 
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semctl(2) .. siateee semaphore control operations 
semget(2) . .. get set of semaphores 
semop(2) semaphore operations 


setpgid(2) . 
setpgrp(2) . 
setsid(2) .... 
setuid(2): setuid, setgid 
shmctl(2) .. 


manipulate signal sets 

set process group ID 

create session and set process group ID 
set user and group IDs 

shared memory control operations 


shmget(2) . get shared memory segment identifier 
shmop(2): shmop, shmat, shmdt shared memory operations 
sigaction(2) examine and change signal actions 


sigemptyset(2): sigemptyset, 
sigfillset, sigaddset, sigdelset, 
sigismember 
signal(2) ...... 
sigpending(2) 
sigprocmask(2) 
sigset(2): sigset, sighold, sigrelse, 
sigignore, sigpause 
sigsuspend(2) .. 
stat(2): stat, Istat, fetat 
statfs(2): statfs, fetatfs 
stime(2) ......s00 sesbebedésscdes 
stty(2): stty, gtty 
BYDC(Z) ereses 
syscall(2) 


.. Manipulate signal sets 

specify what to do upon receipt of a signal 
examine pending signals 

... examine and change blocked signals 


.. Signal management 

wait for a signal 

get file status 

get filesystem information 

. Set time 

.. set and get terminal state (defunct) 
update superblock 

indirect system call 


syscon{(2) . get configurable system variables 
sysi86(2) ... machine specific functions 
tegetattr(2): tegetattr, tesetattr get/set terminal state 
tegetpgrp(2) . get foreground process group ID 
tesetpgrp(2) set foreground process group ID 
time(2) .. get time 


times(2) . get process and child process times 
uadmin(2) ... administrative control 

ulimit(2) ... .. get and set user limits 

umask(2) .. set and get file creation mask 


umount(2) unmount a filesystem 

uname(2) .. get name of current operating system 

unlink(2) remove directory entry 

ustat(2) .. get filesystem statistics 

utime(2) set file access and modification times 

vfork(2) .. . Spawn new process in a virtual memory efficient way 


wait for a child process to stop or terminate 
.. Write on a file 


wait(2): wait, waitpid 
write(2) 
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2SEQ Sequent System Calls 


intro(2SEQ) 
bdflush(2SEQ) 
fvhangup(2SEQ) . 
get_process_stats(2SEQ) 


.. introduction to Sequent system calls 

.. update daemon 

virtually hangup the specified controlling terminal 
get resource utilization information 


getdtablemax(2SEQ) ..... .. get maximum in-use descriptor table index 
getdtablesize(2SEQ) . .. get descriptor table size 
getpagesize(2SEQ) .. get system page size 

mmap(2SEQ) ...... .. map an open file into the processs address space 
munmap{2SEQ) . .. unmap part of the processs address space 
proc_ctl(2SEQ) ... .. control over various process attributes 
quotactl(2SEQ) .. manipulate disk quotas 

readlink(2SEQ) .. read value of a symbolic link 

readv(2SEQ) ....... .. read vector from file 

setdtablesize(2SEQ) .. .. Set descriptor table size 

setgroups(2SEQ) ... .. Set group access list 

sigcontext(2SEQ) .. get signal context 

sigstack(2SEQ) ... .. set and/or get signal stack cpinteat 
symlink(2SEQ) .. make symbolic link to a file 


tmp_affinity(2SEQ 
tmp_ctl(2SEQ) 
truncate(2SEQ): truncate, 


.. bind a process to a processor 
.. multi-processor contro] 


ftruncate ......... truncate a file to a specified length 
vm_ctl(2SEQ) . .. examine and change virtual memory tuning parameters 
writev(2SEQ) .. .. Write vector on a file 


8 Subroutines 
TESS) aicactcmssssinsenmnnnibivinisiativiteviartiorisin introduction to functions and libraries 


3C C Library Routines 


a641(3C): 2641, 164a . .. convert between long integer and base-64 ASCII string 


abort(3C) .. generate an IOT fault 
aba(3C) .. .. return integer absolute value 
bsearch(3C) .. binary search a sorted table 
clock(3C) .. Teport CPU time used 


conv(3C): toupper, tolower, 

_toupper, _tolower, toascii . .. translate characters 
crypt(3C): crypt, setkey, encrypt ........ generate hashing encryption 
ctime(3C): ctime, localtime, 

gmtime, asctime, cftime, ascftime, 

mktime, tzset . 
ctype(3C): isdigit, iaxdigit, 

islower, isupper, isalpha, isalnum, 

isspace, iscntrl, ispunct, isprint, 

isgraph, isascii, tolower, toupper, 

toascci, _tolower, _toupper, 

BEtChrelass ....ccscscscssssssssssserecessesscsensscneere character handling 


convert date and time to string 
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dev_to_ttyname(3C): dev_to_ttyname, 
ttyname_to_dev 
dial(3C) 
drand48(3C): drand48, erand48, 
lrand48, nrand48, mrand48, 
jrand48, srand48, seed48, Icong48 
ecvt(3C): ecvt, fevt, gcvt ..... 
end(3C): end, etext, edata ... 
fpgetround(3C): fpgetround, 
fpsetround, fpgetmask, fpsetmask, 
fpgetsticky, fpsetsticky 
frexp(3C): frexp, Idexp, modf .. 
fiw(3C) .. 
getewd(3C; 
getenv(3C) ... 
getgrent(3C): getgrent, getgrgid, 
getgrnam, setgrent, endgrent, 
fgetgrent 
getlogin(3C) . 


convert between major/minor numbers and tty names 
.. establish an out-going terminal line connection 


generate uniformly distributed pseudorandom numbers 
convert floating-point number to string 
.- last locations in program 


.. IEEE floating-point environment control 
manipulate parts of floating-point numbers 
walk a file tree 

get pathname of current working directory 
.. Teturn value for environment name 


.. get group file entry 
get login name 


getopt(3C) .... .. get option letter from argument vector 
getpass(3C) .. .. Tead a password 
getpw(3C) .. .. get name from UID 


getpwent(3C): getpwent, 
getpwuid, getpwnam, setpwent, 

endpwent, fgetpWent seen Bet password file entry 
getut(3C): getutent, getutid, 

getutline, pututline, setutent, 

endutent, utmpname, getutpid ............ access utmp file entry 
hsearch(3C): hsearch, hcreate, 

Wdestroy  escccrsssscsssecsssecsseoses 
isnan(3C): isnand, isnanf 
13tol(3C): 13tol, ltol3 .. 
Tock {(3C) ...ssssesssereeeee 
lsearch(3C): lsearch, lfind 
malloc(3C): malloc, free, realloc, 

CANO sieiscsssascsessssessees es bavsubusuinecsscewsessasuvs main memory allocator 
memory(3C): memccpy, memchr, 

memcmp, memcpy, memset . 


.. manage hash search tables 

.. test for floating-point NaN (Not-A-Number) 

.. convert between 3-byte integers and long integers 
record locking on files 

.. linear search and update 


memory operations 


mkfifo(3C) . .. make a FIFO special file 
mktemp(3C) make a unique filename 
monitor(3C) . prepare execution profile 


nlist(3C) .... 
perror(3C): perror, errno, 
sys_errlist, sys_nerr 


. get entries from name list 


system error messages 


putenv(3C) .... . change or add value to environment 
putpwent(3C) . Write password file entry 
QBOFt(3C) ...cssssees . quicker sort 


rand(3C): rand, srand 
setjmp(3C): setjmp, longjmp .. 
setlocale(3C) .. 


simple random-number generator 
non-local goto 
set programs location 
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sigsetjmp(3C): sigsetjmp, 
siglongjmp . 


.. non-local jumps 
sleep(3C) ... 


suspend execution for interval 

ssignal(3C): ssignal, gsignal software signals 

stdipe(3C) .. standard interprocess communication package 
strftime(3C) .. .- format time information 

string(3C): strcat, strdup, strncat, 

stremp, strncemp, strepy, strncpy, 

strlen, strchr, strrchr, strpbrk, 

strspn, strcespn, strtok 
Strstr(3C) wees asskebese 
strtod(3C): strtod, atof . 
strtol(3C): strtol, atol, atoi . 
SWAD(3C)  cresscssssseosenssercees soee 
tsearch(3C): tsearch, tfind, 


.. string operations 

find first occurrence of character 

convert string to double-precision number 
convert string to integer 

.. swap bytes 


tdelete, tFwalk ciccsscscssssscessseses .. manage binary search trees 
ttyname(3C): ttyname, isatty .. find name of a terminal 
ttyslot(3C) w.esssscsccscssseees sais idi .. find the slot in the utmp file of the current user 


3M Mathematical Library Routines 


bessel(3M): jO, jl, jn, yO, yl, yn . . Bessel functions 

eTM(3M): erf, CYfe ...eesscsecssesseees : .. error function and complementary error function 
exp(3M): exp, log, log10, pow, sqrt .... exponential, logarithm, power, square root functions 
floor(3M): floor, ceil, fmod, fabs . .. floor, ceiling, remainder, absolute value functions 
gamma(3M) . . log gamma function 


hhypot(3M) .. . Euclidean distance function 
matherr(3M) . error-handling function 
sinh(3M): sinh, cosh, tanh ... .. hyperbolic functions 
trig(3M): sin, cos, tan, asin, acos, 

atan, atan2 ....... sasessevseeenesseavsscaseeossonceveee trigonometric functions 

38N Networking Support Utilities 

t_accept(3N) accept a connect request 
t_alloc(3N) allocate a library structure 


t_bind(3N) . bind an address to a transport endpoint 

.. Close a transport endpoint 

.. establish a connection with another transport user 
produce error message 


free a library structure 


get protocol-specific service information 
t_getstate(3N) . get the current state 
t_listen(3N) ... listen for a connect request 


t_look(3N) look at the current event on a transport endpoint 


t_open(3N) ... establish a transport endpoint 

t_optmgmt(3N) manage options for a transport endpoint 

t_rev(3N) «0000. receive data or expedited data sent over a connection 
t_reveonnect(3N) receive the confirmation from a connect request 
t_revdis(3N) . retrieve information from disconnect 


t_revrel(3N) .... .. acknowledge receipt of an orderly release indication 
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. Teceive a data unit 

receive a unit data error indication 

send data or expedited data over a connection 
send user-initiated disconnect request 
initiate an orderly release 

send a data unit 

synchronize transport library 

.. disable a transport endpoint 


t_revudata(3N) ... 
t_revuderr(3N) 
t_snd(3N) . 
t_snddis(3N) 
t_sndrel(3N) .... 

t_sndudata(3N) ... 
t_sync(3N) ....... 
t_unbind(3N) .. 


SPPS Sequent Parallel Programming Library 


UNtTO(SPPS) ...ecscsssssesesersessssscesssssserersreees introduction to Parallel Programming Library 
brk(3PPS): brk, sbrk .. change private data segment size 
cpus_online(3PPS) . returns the number of CPUs on-line 
m_fork(3PPS) ..... execute a subprogram in parallel 
m_get_myid(3PPS) ... return process identification 
m_get_numprocs(3PPS) return number of child processes 


m_kill_procs(3PPS)  ........+. kill child processes 

m_lock(3PPS): m_lock, m_unlock lock, unlock locks 

m_next(3PPS) .. increment global counter 
m_park_proca(3PPS): m_park_procs, 

m_rele_procs ..... i .. Suspend and resume child process execution 


m_set_procs(3PPS) .. set number of child processes 
m_single(3PPS): m_single, 

M_MUI ti ...sscseoee 
m_sync(3PPS) .. 
s_lock(3PPS): s_init_lock, s_lock, 

B_clock, 8_UNIOCK wssssesseeneneee initialize, lock, unlock locks 
s_wait_barrier(3PPS): s_init_barrier, 

B_WAIE_DAQTICN csssssssssssciicccssssscsesstsansesass initialize barrier, wait at barrier 
shbrk(3PPS): shbrk, shsbrk ............... change shared data segment size 
shmalloc(3PPS): shmalloc, 

Bhrealloc, sh{ree ...c.sccsssssssesssesseesseessesees shared memory allocator 


.. mark single-process code section 
.. check in at barrier 


8S Standard I/O Library Routines 


ctermid(3S) .. 
cuserid(3S) ... 
felose(3S): fclose, flush 
ferror(3S): ferror, feof, clearerr, 

FICTIO ..reressssesssoessssesrseensarevensnvscesen sme Stream status inquiries 

fopen(3S): fopen, freopen, fdopen ....... open a stream 

fread(3S): fread, fwrite .......... . binary input/output 

feeek(3S): fseek, rewind, ftell .. Teposition a file pointer in a stream 
getc(3S): getc, getchar, fgetc, getw .... get character or word from a stream 


.. generate filename for terminal 
get character login name of the user 
.. close or flush a stream 


gets(3S): gets, fgets .......... .. get a string from a stream 
popen(3S): popen, pclose .. initiate pipe to/from a process 
print{(3S): printf, fprintf, sprintf ....... print formatted output 


14 DYNIX/ptx Reference Manual 


Contents 


putc(3S): pute, putchar, fputc, 
putw 
puts(3S): puts, fputs ... 


.. put character or word on a stream 

.. put a string on a stream 

scanf(3S): scanf, fecanf, sscanf .. convert formatted input 

setbuf(3S): setbuf, setvbuf . assign buffering to a stream 

stdio(3S) ...... standard buffered input/output package 


system(3S) issue a shell command 

tmpfile(3S) .. create a temporary file 

tmpnam(3S): tmpnam, tempnanm ...... create a name for a temporary file 

WNgetC(SS) . sccsassssesversesesssevsnsovesesessseesssesoss push character back into input stream 
vprint{(3S): vprintf, vfprintf, 

VEDPEDEL  scsssscssssessosnesescesessocisoveseqseaseszuiioss print formatted output of a varargs argument list 


38SEQ Sequent I/O Library Routines 


dis386(3SEQ) .... disassemble Series 386 instructions 
getgeombyname(3SEQ) ... .. get disk geometry by name 
getmntent(3SEQ): addmntent, 

endmntent, getmntent, 

hasmntopt, setmntent .......ssssesseseesees get file system descriptor file entry 
Betpseudotty(BSEQ) ..ccccccssecersssscsseseeee get pseudo terminals 
getscsiinfo(3SEQ): getscsiinfo, 

Betscsimatch ....cserecssscsessossesssssvssssesserses get scsiinfo structure 
getusclk(3SEQ): getusclk, 

usclk_init .... .. get/init microsecond clock 


getzdinfo(3SEQ): getzdinfo, 


getzdinfobyname ... .. get zdinfo structure 


initgroups(3SEQ) initialize group access list 

nblocks(3SEQ) ... calculate number of blocks and indirect blocks 
offline_all(3SEQ) ... take all but one active processor off line 
read_constab(3SEQ) . read constab entries into a structure 
valloc(8SEQ) .. aligned memory allocator 


8X Special Routines 


verify program assertion 
.. password and file encryption functions 
.. terminal screen handling and optimization package 


directory(3X): opendir, readdir, 

telldir, seekdir, rewinddir, closedir .... directory operations 
getspent(3X): getspent, getspnam, 

setspent, endspent, fgetspent, 


Ickpwdf, ulckpwdf . .. get shadow password file entry 


Idahread(3X) ........00 read the archive header of a member of an archive file 
ldclose(3X): Idclose, Idaclose close a common object file 

ldfhread(3X) ...... read the file header of a common object file 
ldgetname(3X) .... .. retrieve symbol name for common object file symbol 


table entry 
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Idlread(3X): Idlread, ldlinit, ldlitem .. manipulate line number entries of a common object 
file function 
Idlseek(3X): ldlseek, Idnlseek.............-. seek to line number entries of a section of a common 
object file 
.. Seek to the optional file header of a common object file 
open a common object file for reading 
.. seek to relocation entries of a section of acommon 
object file 
Idshread(3X): Idshread, Idnshread .... read an indexednamed section header of a common 
object file 
.. seek to an indexednamed section of a common object file 
.» compute the index of a symbol table entry of a 
common object file 
.. read an indexed symbol table entry of a common object file 
.. seek to the symbol table of a common object file 


Idohseek(3X) 
Idopen(3X): Idopen, Idaopen .. 
Idrseek(3X): ldrseek, ldnrseek ... 


Idsseek(3X): ldsseek, Idnsseek . 
Idtbindex(3X) .. 


ldtbread(3X) ... 
Idtbseek(3X) ... 


Togname(3X)  ...secscsssssessssssssesesersseecseessenes return login name of user 
malloc(3X): malloc, free, realloc, 
Calloc, mallopt, MAl]iMfO ....s.sssseeesseeeeee ‘fast main memory allocator 


ndbm(3X): dbm_open, dbm_close, 
dbm_fetch, dbm_store, 
dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, 


dbm_clearerr, dmb_blkflush database subroutines 


plot(3X) «0.8 graphics interface subroutines 

putspent(3X) write shadow password file entry 

regemp(3X): regemp, regex .. compile and execute regular expression 

sputh(3X): sputl, sgetl] .....cccecssssceceeres access long integer data in a machine-independent fashion 
utadduser(3X): ut_add_user, 

ut_delete_user sess seacissteseioasessiesas add/delete users in utmp file 


4 File Formats 


TRENOCA)! sssasscascsvssstveacsssencrsvanvaccorhesssvesccunssa introduction to file formats 

a.out(4) .. .. common assembler and link editor output 
acct(4) .... per-process accounting file format 
addusr_def(4) add user defaults 

alias(4) .. alias file for FACE 

ar(4) ... see C and Language Tools Binder 
backup_codes(4) . backup cycle code definitions 
backup_codes1(4) .. backup subcode definitions 
backup_dev(4) . .. backup devices 

backup_info(4) . backup set definitions 


eftime(4) ....... language specific strings 

checklist(4) .. list of filesystems processed by fsck and ncheck 
constab(4) constructed devices table 

core(4) ... format of core image file 

cpio(4) ..... format of cpio archive 


cronlog(4) cron history file 
crontabs(4) clock daemon file 
devtab(4) ...... .. Virtual device table 
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.. format of directories 

file system independent directory entry 
disk device characteristic database 
incremental dump format 

.. FACE files 

.. internal error log file 

error message text file 

file header for common object files 
format of file system volume 


dump(4): dump, dumpdates 
env(4): .environ, .pref, variables . 
errorlog(4) .... 
errormsg(4) 
filehdr(4) ... 
fs(4): fs,inode . 


fspec(4) .. format specification in text files 

fstab(4) ... file-system-table 

gettydefa(4) speed and terminal settings used by getty 

gps(4): gps graphical primitive string, format of graphical files 
group(4) .. group file 

helplog(4) monitor help actions 

init.d(4) . .. system level transition files directory 


inittab(4) .. script for the init process 

i issue identification file 

common object file access routines 

file header for implementation-specific constants 
line number entries in a common object file 
log of failed login attempts 

table of printer types supported by the menu system 
mounted filesystem table 

format of a module configuration file 
message-of-the-day file 

. files that hold object architecture information 
.. password file 

graphics interface 

installed products file 

setting up an environment at login time 
prototype job file for at 

reboot and shutdown command scripts 

format of RCS file 

relocation information for a common object file 
format of SCCS file 

section header for a common object file 

.. format of curses screen image file 


shadow(4) . .. restricted password file 

shells(4) .... shell table 

shutdown(4) . system shutdown information file 
spellhist(4) ... unmatched spelling words file 

sulog(4) ... log of substitute user events 

syms(4) .. common object file symbol table format 
sys_config(4) format of a system configuration file 
syskeymap(4) identify keys to internal menu system functions 
task(4) ... global security table 

term(4) .. format of compiled term file 
termcap(4) terminal capability data base 
terMimfO(d) ..rccscsecsssessrecssererceseneses ... terminal capability database 
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.. set default system time zone 
.. file header for symbolic constants 
.. utmp and wtmp entry formats 


timezone(4) 
unistd(4) 
utmp(4): utmp, wtmp 


uucp(4) .. networking support files 

5 Miscellaneous 

STHEEO(B)) sascsciscesssssancosnszanseatesvavancseeseeaecsnnts introduction to miscellany 
ascii(5) .. map of ASCII character set 
environ(5) .. user environment 

fentl(5) ..... .. file control options 

math(5) ... .. math functions and constants 
proft5) ... .. profile within a function 


.. regular expression compile and match routines 
.. data returned by stat system call 

.. conventional names for terminals 

.. primitive system data types 

.. machine-dependent values 

handle variable argument list 


regexp(5) . 
stat(5) 
term(5) . 
types(5) 
values(5) . 
vararga(5) ... 


7 Special Files 


.. introduction to special files 

open any minor device on a STREAMS driver 
compatibility partitioning driver 

pseudoconsole driver 

console memory drivers 

console interface 

MULITBUS memory 

STREAMS tty line discipline 

.. interface to STREAMS error logging and event tracing 


intro(7) .... 
clone(7) . 
cmpt(7) . 
C1(7) ssveee 
consmem(7): consmem, 8m, 88 
CONEOE(7) sossrsesserereverneneessnserseenes 
kmmem(7): kMBmem, kMWmem 
1d0(7) saseaatcane 
log(7) 


1p(7)_ .. Systech parallel line printer interface 
Ipmod(7) .. parallel printer canonical processing module 
mbad(7) .. MULITBUS adapter 


mem(7): mem, kmem 
mtio(7) ... 
null(7) ... 
pmap(7) 


sa(7) ... 
sced(7) 
sd(7) ... 
8p(7) ... 
ssm(7) 
st(7) ... 
streamio(7) . 
streampty(7) 


core memory 

UNIX magnetic tape interface 

.. the null file 

.. map physical addresses into processs virtual address 
space 

.. devices administered by System Administration 

. SCSI/Ethernet/Diagnostics board 

.. SCSI disk controller 

. STREAMS pipe device 

. System Services Module 

. Systech MTI-800/1600/1650 terminal multiplexor driver 

. STREAMS ioct] commands 

. STREAMS pseudo terminal driver 


streamtty(7) . Generic STREAMS tty driver interface 
termio(7) .. . general terminal interface 
tg(7) SCSI 1/2-inch magnetic tape interface 
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timod(7) ... .. Transport Interface cooperating STREAMS module 
tirdwr(7) .. Transport Interface read/write interface STREAMS module 
tm(7) .. .- SCSI tape controller 

ts(7) ... .. SCSI tape controller 

tty(7) .. .. controlling terminal (gentty) interface 

usclk(7) . .. 82-bit microsecond counter 

vtoc(7) .. VTOC partitioning driver 

wd(7) . .. SSM SCSI disk controller 

wp(7) . .. SSM parallel line printer interface 

x8(7) .. .. Xylogics 781 terminal multiplexor driver 

xt(7) .. .. Xylogics 472 MULITBUS magnetic tape interface 
zd(7) ... .. dual-channel disk controller 


8 Stand-Alone Utilities 


intro(8) .. introduction to system standalone utilities 
ccsformat(8) .. standalone embedded SCSI disk formatter 
boot(8) .. run a standalone program or bring up the operating 


system 
.. perform a standalone data transfer 
.. Standalone memory dump 
.. print the VTOC of a standalone disk device 


zdformat(8) . .. standalone disk formatter for dual-channel disk controller 
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st: Systech MTI-800/1600/ 

hpio: Hewlett-Packard 

of DASI 300 and 300s terminals 
handle special functions of DASI 
DASI 300 and 300sterminals 300, 
special functions of DASI 300 and 
usclk: 

dis386: disassemble Series 

DASI 450 terminal 

handle special functions of the DASI 
xt: Xylogics 

between long integer and base- 

xs: Xylogics 

integer and base-64 ASCII string 


abs: return integer 

fabs: floor, ceiling, remainder, 
t_accept: 

requests 

utime: set file 

touch: update 

file 

initgroups: initialize group 
setgroups: set group 
machine-independent/ _sputl, sgetl: 
ldfen: common object file 
endutent, utmpname, getutpid: 
access: determine 

acct: enable or disable process 
acctcon1, acctcon2: connect-time 
acctprel, acctpre2: process 
turnacct: shell procedures for 
runacct: run daily 

/accton, acctwtmp: overview of 

of accounting and miscellaneous 
diskusg: generate disk 

acct: per-process 

acctcom: search and print process 
acctmerg: merge or add total 
command summary from per-process 
fwtmp, wtmpfix: manipulate connect 
accounting 

format 

per-process accounting records 
accounting files 

accounting 
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1650 terminal multiplexor driver... 
2645A terminal tape file archive 
300, 300s: handle special functions. 
300 and 300s terminals... 
300s: handle special functions of. 
300s terminals........ssssseren 
32-bit microsecond counter. 
386 instructions. 
450: handle special functions of the 
450 terminal ssscscsssissrsccrssssssetcsccees 
472 MULITBUS magnetic tape interface 
64 ASCII string... 
781 terminal multiplexor driver. 
a64]l, 164a: convert between long.. 
abort: generate an IOT fault... 
abs: return integer absolute value... 


absolute value ....cscsesoreeeen 

absolute value functions.. 

accept A CONNCCt Fequest....corceene oo 

accept, reject: allow or prevent LP. accept(1M) 
access and modification times...... utime(2) 


access and modification times of a file 
access: determine accessibility of a. 
access list... 
access list. 
access long integer data in a.. 
ACCESS TOULINGS.......004+ 
access utmp file entry 
accessibility of a file.. 
accounting... + acct(2) 


sacctcon 1M) 


accounting 

accounting. .acctpre( 1M) 
accounting ...acctsh(1M) 
accounting... -runacct(1M) 
accounting and miscellaneous/. acct(1M) 
accounting commands ...acct(1M) 
accounting data by user ID. .diskusg( 1M) 
ACCOUNtING file format .....ssscsesescsessssecescsssnsecessssessences acct(4) 
P(esolihe (abr 4) il (ct: Onmeperenrreter rarer fret rerrrtrty ereeerrereetrt acctcom(1) 
accounting files... .acctmerg( 1M) 
accounting records. acctcms(1M) 
accounting records.... fwtmp(1M) 


+ acet(2) 
.acct(4) 
acctcms(1M) 
...acctcom(1) 
-acctcon(1M) 


acct: enable or disable process.. 
acct: per-process accounting file 
acctems: command summary from... 
acctcom: search and print process. 
acctcon1, acctcon2: connect-time 
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acctcon1, 

acctwtmp: overview of accounting/ 
of accounting and/ acctdisk, 
accounting files 

acctdisk, acctdusg, 


accounting 

acctprel, 

acctdisk, acctdusg, accton, 

release indication t_revrel: 


trig: sin, cos, tan, asin, 

helplog: monitor help 

sigaction: examine and change signal 
killall: kill all 

offline_all: take all but one 
mbad: MULITBUS 

addcmdopt: 

addformopt: 

addmenuopt: 

acctmerg: merge or 
addusr.def: 

putenv: change or 

menu 

ut_add_user, ut_delete_user: 
option to a menu 

menu 

hasmuntopt, setmntent: get file/ 
map an open file into the processs 
munmap: unmap part of the processs 
addresses into processs virtual 
t_bind: bind an 

pmap: map physical 


menu 


files 
print service Ipfilter: 
print service Ipforms: 


admin: create and 

SA: devices 

SA: devices administered by System 
sysadm: menu interface to do system 
uadmin: 

uadmin: 

swap: swap 

fusr/ 

/onproc: run a command with priority 
alarm: set a process 


/display application specific 
pathalias: 

valloc: 

t_alloc: 

brk, sbrk: change data segment space 
free, realloc, calloc: main memory 


acctcon2: connect-time accounting... .acctcon(1M) 
acctdisk, acctdusg, accton,. ...acct(1M) 
acctdusg, accton, acctwtmp: overview. ..acct(1M) 
acctmerg: merge or add total .....cssesessseseaseese acctmerg(1M) 
accton, acctwtmp: overview of accounting and/.....acct(1M) 
acctprel, acctpre2: process. -acctpre(1M) 
acctpre2: process accounting.. -acctpre(1M) 
acctwtmp: overview of accounting and/.. ..acct(1M) 
acknowledge receipt of an orderly... t_revrel(3N) 
acos, atan, atan2: trigonometric/, 
actions 
actions 
active processes. 
active processor off line. 


“sigaction(2) 
»-killall(1M) 
..offline_all(3SEQ) 


BOSDET cn cmmicmeminemannennmmA mbad(7) 
add a command option to a menu. -addcmdopt(1M) 
add a form/SELECT window option to a.....addformopt(1M) 
-add a menu option to a menu.. ..addmenuopt(1M) 
add total accounting files. -acctmerg(1M) 
add user defaults .........00 .addusr_def(4) 
add value to environment putenv(3C) 
addcmdopt: add a command option to a.....addemdopt(1M) 
add/delete users in utmp file ..utadduser(3X) 


addformopt: add a form/SELECT window...addformopt(1M) 
addmenuopt: add a menu option to a.......addmenuopt(1M) 
addmntent, endmntent, getmntent,. .getmntent(3SEQ) 
address space. -mmap(2SEQ) 
address space munmap(2SEQ) 
address space... ..pmap(7) 
address to a transport endpoint. _bind(3N) 
addresses into processs virtual address spacc........ pmap(7) 
addusr.def: add user defaults .addusr_def(4) 
admin: create and administer SCCS.....scsssssesseseeees admin(1) 
administer filters used with the LP.. -|pfilter(1M) 
administer forms used with the LP lpforms(1M) 
administer SCCS files ........cccscoeeees ..admin(1) 
administered by System Administration 
Administration.. 
administration. 
administrative control. 
administrative control... 
administrative interface 
adm/loginlog: log of failed login attempts.. 
aging, PFF, swapping, or processor/. 
Alarm ClOCK isssscssecsesscsssasssasisevatusnsa 
alarm: set a process alarm clock 
alarms andW/or the working indicator. 
alias file for FACE.........0+008 
aligned memory allocator. 
allocate a library structure.. 
allocation. 
allocator... 


swap(1M) 
--loginlog(4) 
noage(1M) 
..alarm(2) 
..alarm(2) 
-indicator{1F) 

mia alias(4) 
-valloc(3SEQ) 
t_alloc(3N) 
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mallopt, mallinfo: fast main memory 
shrealloc, shfree: shared memory 
valloc: aligned memory 

editor output 

to maintenance commands and 

the working/ indicator: display 
lookup 


and libraries 

be: 

ott: files that hold object 

cpio: format of cpio 

the archive header of a member of an 
ar: common 

ldahread: read the 
2645A terminal tape file 
tar: tape file 

cpio: copy file 

varargs: handle variable 
print formatted output of a varargs 
xargs: construct 

getopt: get option letter from 

echo: echo 

expr: evaluate 

message: puts its 

be: arbitrary-precision 

asa: interpret 

characters 

Aocaltime, gmtime, asctime, cftime, 
ascii: map of 


archive file 


between long integer and base-64 
ctime, localtime, gmtime, 

trig: sin, cos, tan, 

. as: common 

a.out: common 


assert: verify program 

system commands 

/program for generating/modifying 
assist: 

generating/modifying ASSIST menus/ 
later time 

trig: sin, cos, tan, asin, acos, 

/sin, cos, tan, asin, acos, atan, 
double-precision number strtod, 
strtol, atol, 

strtol, 

change login password and password 
control over various process 

res: change RCS file 

dumpconf: dump kernel 
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allocator.. malloc(3X) 
allocator -8hmalloc(3PPS) 
allocator. valloc(3SEQ) 
a.out: common assembler and link . -8,out(4) 


application programs.......... 
application specific alarms and/o’ ni cator(1F) 
apropos: locate commands by keyword.. ...apropos(1) 
ar: archive file format... ..8ee C and Lang Tools Binder 
ar: maintain archives... ..8ee C and Lang Tools Binder 
arbitrary-precision arithmetic language... -be(1) 
.0tt(4) 


see C and Lang Tools Binder 
archive header of a member Of AN. ......sssseesseees Idahread(3X) 
archiver.. .-hpio(1) 
archiver... .tar(1) 
archives in and out cpio(1) 


argument list...... 
argument list.... 


argument list(s) and execute command. xargs(1) 
ATQUMENE VECLOL....sseserseseecscarereree getopt(3C) 
ATQUMENLS....-secscossesseseesneneasen echo(1) 


arguments as an expression 
arguments on message line 
arithmetic language.. 
ASA carriage contro] characters 
asa: interpret ASA carriage control. 
ascftime, mktime, tzset: convert/.. 
ASCII character St ...cccccssssesseees 
ascii: map of ASCII character se 
ASCII string 
asctime, cftime, ascftime, mktime, tzset/.. 
asin, acos, atan, atan2: trigonometric/ 
ASSEMDIEL....sccssssssscsceseereseeaseess see C and Lang Tools Binder 


asa(1) 


ascii(5) 


.ctime(3C) 
.trig(3M) 


assembler and link editor output... -a.out(4) 
assert: verify program assertion assert(3X) 
BSBOTCION wscecessaduscosenscssassinsitsanacanies assert(3X) 
assist: assistance using operating. --assist(1) 


ASSIST menus or command formas..... 
assistance using operating system commands 
AStYEN: Program fOF........ccssesesesesscessersserencarecnersseeee 
at, batch: execute commands at a..... 
atan, atan2: trigonometric functions 
atan2: trigonometric function: 
atof: convert string to 
atoi: convert string to integer.. 
atol, atoi: convert string to integer 
attributes...... 
attributes 
attributes... 
auto-configuration device table.. 


astgen(1) 
assist(1) 


.strtol(3C) 
-strtol(3C) 
... passwd(1) 
.-proc_ctl(2SEQ) 
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language 

backup.codes: 

backup.dev: 

ckbupscd: check filesystem 
backup.info: 
backup.codes1: 

definitions 

definitions 


m_synce: check in at 
initialize barrier, wait at 
/s_wait_barrier: initialize 
of pathnames 

at, 

language 

procedures 


bessel: jO, j1, jn, yO, yl, yn: 
Bessel functions 


fread, fwrite: 

bp: 

bsearch: 

tfind, tdelete, twalk: manage 
tmp_affinity: 

t_bind: 

sum: print checksum and 

prtvtoc: print the VTOC of a 
sigprocmask: examine and change 
number of blocks and indirect 
nblocks: calculate number of 

df: report number of free disk 
consistency check based on the 
consistency check based on the BOM 
bootflags: display/change system 
installboot: installs a 

bring up the operating system 
boot flags 


allocation 

segment size 

table 

stdio: standard 
setbuf, setvbuf: assign 
mailbug: submit a 
devbuild, devdestroy: 
sccstorcs: 

mknod: 


-bcheckre: system initialization. 


awk: pattern scanning and processing.. 
backup cycle code definitions... 
backup devices. 
backup schedule .. 
backup set definitions. 
backup subcode definitions.. 
backup.codes: backup cycle code 
backup.codes1: backup subcode... 
backup.dev: backup devices.... 
backup.info: backup set definitions. 
banner: make posters... 


..backup_codes(4) 
.-backup_dev(4) 
...ckbupsed(1M) 
-backup_info(4) 
backup_codes1(4) 
..backup_codes(4) 
backup_codes1(4) 
-backup_dev(4) 
-backup_info(4) 
..banner{1) 
«.m_synce(3PPS) 
s_wait_barrier(3PPS) 
barrier, wait at barrier. s_wait_barrier(3PPS) 
basename, dirname: deliver portions............ basename(1) 
batch: execute commands at a later time. 
be: arbitrary-precision arithmetic. 


bdflush: update daemon 
bdflush: update daemon. 
bdiff: big diff... 
Bessel functions 
bessel: j0, jl, jn, yO, y1, yn: 
bfs: big file scanner. 
binary input/output. 
binary patcher......... 
binary search a sorted table. 
binary search trees. 
bind a process to a processor 
bind an address to a transport endpoint.. 
block count of a file.. 
block device .. 
blocked signals. 
BOCK Si isssecenssascce 
blocks and indirect blocks.. 
blocks and inodes.. 


bomverify: perform an installation. 
boot flags......ccsesseresseseeeeroenenes 
boot program on a disk.......... 
boot: run a standalone program or. 
bootflags: display/change system 


brk, sbrk: change data segment space. 
brk, sbrk: change private data..... 
bsearch: binary search a sorted 
buffered input/output package . 
buffering to a stream.. 
bug report or enhancement reques' 
build and destroy virtual devices 
build RCS file from SCCS file.. 
build special file.... 


.bsearch(3C) 
...8tdio(3S) 
.setbuf(3S) 


.-secstores(1) 
.-mknod(1M) 
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config: 

swab: swap 

ce: 

cflow: generate 


cxref: generate a 
ctrace: 
list: produce 


nblocks: 
de: desk 
cal: print 


indirect blocks 


stat: data returned by stat system 
syscall: indirect system 

cu: 

malloc, free, realloc, 

malloc, free, realloc, 

introduction to Sequent system 
intro: introduction to system 

Ip, cancel: send/ 

LP print service Ip, 
Ipmod: parallel printer 
description into a terminfo/ 

asa: interpret ASA 


gence: create a front-end to the 
disk formatter 


an SCCS delta 
remainder, absolute value/ floor, 
floor, ceil, fmod, fabs: floor, 


ctime, localtime, gmtime, asctime, 


sigprocmask: examine and 
brk, sbrk: 
passwd: 
chmod: 
chmod: 
putenv: 
chown: 
chown, chgrp: 
nice: 

brk, sbrk: 
res: 

chroot: 
chroot: 


attributes 
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-8ee C and Lang Tools Binder 


C flowgraph... .see C and Lang Tools Binder 
C language preprocessor .see C and Lang Tools Binder 
C program beautifier.. .see C and Lang Tools Binder 


C program checker....... 
C program cross-reference.. 
C program debugger. 
C source listing... 
cal: print calendar 
calculate number of blocks and. 


see C and Lang Tools Binder 
see C and Lang Tools Binder 
.see C and Lang Tools Binder 
.see C and Lang Tools Binder 


calculator. -de(1) 
calendar.. cal(1) 
calendar: reminder service calendar(1) 
Call cacccassseneers ...stat(5) 
Call cccsscscesssmesccseras ..8yscall(2) 


call another UNIX system 
calloc: main memory allocator. 
calloc, mallopt, mallinfo: fast main memory. 
calls...... 
calls and error numbers. 
cancel requests to the LP print service. 
cancel: send/cance] requests to the.. 
canonical] processing module..... 
captoinfo: convert a termcap. 
carriage control characters... 
cat: concatenate and print files... 
see 


..cu(1C) 


-captoinfo(1M) 
.asa(1) 


asasstatateatintscsattt exe Bennce( 1M) 
see C and Lang Tools Binder 
CCSformat: standalone embedded SCS...........ccsformat(8) 


cd: change working directory....s..scssssssssssecsnsseesessrseceees cd(1) 
cde: change the delta commentary of.. cde(1) 
ceil, fmod, fabs: floor, ceiling,....... ..floor(3M) 


ceiling, remainder, absolute value/. ..floor(3M) 
cflow: generate C flowgraph...see C and Lang Tools Binder 
cftime, ascftime, mktime, tzset/.. ..<ctime(3C) 
cftime: language specific strings... .¢fhtime(4) 


change blocked signals............ ..Sigprocmask(2) 
change data segment space allocation.....csssssssssssesrsee brk(2) 
change login password and password. passwd(1) 
change mode......... chmod(1) 
change mode of file -chmod(2) 
change or add value to environmen’ ..putenv(3C) 
change owner and group of a fil ..chown(2) 
change owner or group........ ewe 1) 


change priority of a process. 
change private data segment size 
change RCS file attribute: 
change root directory......... 


change root directory for a command.. "-chroot(1M) 
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shbrk, shsbrk: 

sigaction: examine and 
bootflags: display/ 

shutdown: shut down system, 
ede: 

newform: 

helpadm: 

rename: 

delta: make a delta ( 


parameters vm_ctl: examine and 


pipe: create an interprocess 

zd: dual- 

standalone disk formatter for dual- 
strstr: find first occurrence of 


ungete: push 

conversion tables __ chrtbl: generate 
_tolower, _toupper, setchrclass: 
cuserid: get 


getc, getchar, fgetc, getw: get 
pute, putchar, fputc, putw: put 
ascii: map of ASCII 

fgrep: search a file fora 

diskinfo: disk device 

asa: interpret ASA carriage control 
_tolower, toascii: translate 

tr: translate 

lastlogin, monacct, nulladm/ 


filesystem directory consistency 
filesystem storage consistency 
checkfsys: 

feck: filesystem consistency 
perform an installation consistency 
checkeq: 
ckbupscd: 
m_sync: 

ci: 

co: 
uucheck: 
eqn syntax. 


permissions file 


processed by fsck and ncheck 

sum: print 

chown, 

/m_rele_procs: suspend and resume 
times: get process and 

wait, waitpid: wait fora 
m_get_numprocs: return number of 
m_kill_procs: kill 

m_set_procs: set number of 


.character classification and 


change shared data segment size 


.shbrk(3PPS) 


change signal actions...... ..sigaction(2) 
change system boot flags.. bootflags( 1M) 
change system state .shutdown(1M) 
change the delta commentary of an SCCS delta.......... cde(1) 


newform(1) 


helpadm(1M) 


change the format of a text file 
change the Help Facility database.. 


change the name of a file .rename(2) 
change) to an SCCS file ....secesssesssssecoressseeesereesenesrerenters delta(1) 
change virtual memory tuning. ..vm_ctl(2SEQ) 
change working directory ......sscssscessscseereesesesansseneseseeees ed(1) 

: change working directory... chdir(2) 
channel.. i 
channel disk controller... 


channel disk controller. 
character back into input stream. 


character handling........00++ 
character login name of the user.. 
character or word from a stream. 
character or word on a stream. 
character set....... 
character string. 
characteristic database 
characters... 

characters . 
characters. 
chargefee, ckpacct, dodisk,. 
chdir: change working directory .. 
check... 
check... 
check a filesystem... 
check and interactive repair.. 
check based on the BOM... 
check documents for correct eqn syntax. 
check filesystem backup schedule 
check in at barrier..... 
check in RCS revisions.. 
check out RCS revisions 
check the uuep directories and.. 
checkeq: check documents for correct.. 
checkfsys: check a filesystem.. 
checklist: list of filesystems... 
checksum and block count of a 
chgrp: change owner or group 
child process execution.... 
child process times. 
child process to stop or terminate 
child processes 
child processes.... 
child processes 


i pane 


‘ ~fgrep(1) 


“check fsys( 1M) 
.».fsck(1M) 
omverify(1M) 
...checkeq(1) 
.ckbupsed(1M) 
m_syne(3PPS) 
weeeCi(1) 

«C0(1) 
uucheck(1M) 
...checkeq(1) 
.checkfsys(1M) 
.checklist(4) 
.sum(1) 
hown(1) 
m_park_procs(3PPS) 
times(2) 
wait(2) 
.m_get_numprocs(3PPS) 
.m_kill_procs(3PPS) 
..M_set_procs(3PPS) 
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file 


command 
classification and conversion/ 


schedule 
nulladm, pretmp/ chargefee, 
chrtb]: generate character 


elri: 

ferror, feof, 

a shell (command interpreter) with 
alarm: set a process alarm 
usclk_init: get/init microsecond 
cron: 

crontabs: 


STREAMS driver 
Idclose, Idaclose: 
close: 

t_close: 


fclose, flush: 
/telldir, seekdir, rewinddir, 


driver 


communicate to a/ cocreate, cosend, 
coreceive, codestroy: communicate/ 
backup.codes: backup cycle 
m_multi: mark single-process 
/cosend, cocheck, coreceive, 


to form error log dmesg: 
setcolor: redefine or create a 


comb: 

to two sorted files 

mcs: manipulate the object file 
cde: change the delta 

aout: 

ldclose, Idaclose: close a 

ldfhread: read the file header of a 
number entries of a section of a 
to the optional file header of a 
relocation entries of a section of a 
indexednamed section header of a 
to an indexednamed section of a 
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chmod: change mode 
chmod: change mode of file.. 
chown: change owner and group of a 
chown, chgrp: change owner or group .. 
chroot: change root directory......... 

chroot: change root directory for a. 
chrtbl: generate character.. 
ci: check in RCS revisions... 
ckbupscd: check filesystem backu 
ckpacct, dodisk, lastlogin, monacct, . 
classification and conversion tables. 
Clear inode..........sccscceescssnsoosesecanerqeenseon 
clearerr, fileno: stream status inquiries. 
C-like syntax... 
clock... 


valarm(2) 


clock.. 

Clock daemon wscsssasacsssssscessasssacaseieseicassevasseaseacesiarscsed cron(1M) 
clock daemon file .crontabs(4) 
clock: report CPU time use: -clock(3C) 
clone: open any minor device on a ...clone(7) 


close a common object file -Idclose(3X) 


close: close a file descriptor 
close or flush a stream..... 
closedir: directory operations. 
clri: clear inode.. 
cmp: compare two files. 
cmpt: compatibility partitioning 
cn: pseudoconsole driver..... 
co: check out RCS revisions.. 
cocheck, coreceive, codestroy: 
cocreate, cosend, cocheck, 
code definition: 
code section... 
codestroy: communicate to a process 
col: filter reverse line-feeds............ 
collect system diagnostic messages... 


combine SCCS deltas..........+. 

comm: select or reject lines common 
comment section... 
commentary of an SC 
common assembler and link editor output. 
common object file...... 
common object file..... 
common object file ..... 
common object file.. 
common object file. 
common object file.. 
common object file 


-ldclose(3X) 
..ldfhread(3X) 
.Idlseek(3X) 
-ldohseek(3X) 
ldrseek(3X) 
.ldshread(3X) 
..Ildsseek(3X) 
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index of a symbol table entry of a 

an indexed symbol table entry of a 
seek to the symbol table of a 
linenum: line number entries in a 
reloc: relocation information for a 
scnohdr: section header for a 

ldfen: 

Idopen, ]daopen: open a 

/manipulate line number entries of a 
ldgetname: retrieve symbol name for 
syms: 
filehdr: file header for 
glossary: definitions of 
comm: select or reject lines 
cocheck, coreceive, codestroy: 
ipes: report inter-process 
stdipe: ftok: standard interprocess 
tfipe: interprocess 
infocmp: 
resdiff: 
cmp: 
sccsdiff: 
diff: differential file 
diff3: 3-way differential file 
dircmp: directory 
cmpt: 
regemp: regular expression 
regemp, regex: 
regexp: regular expression 
term: format of 
ce: C 
ec: forms 
tic: terminfo 
yacc: yet another compiler- 
yace: yet another 
erf, erfc: error function and 
cprs: 
compress, uncompress, zcat: 
pack, pcat, unpack: 
and expand data 
entry of a common object/ Idtbindex: 
cat: 
test: 
files 
pathconf, fpathconf: get 
sysconf: get 
dumpconf: dump kernel auto- 
mod_config: format of a module 
sys_config: format of a system 
config: build system 
showefg: show the 

lpadmin: 


symbols 


descriptions 


-communication reporter... 


.ldtbindex(3X) 
dtbread(3X) 
dtbseek(3X) 
inenum(4) 
-reloc(4) 
.scnhdr(4) 


common object file... 
common object file 
common object file 


common object file... 


common object file access routines 1 dfen(4) 
common object file for reading ..ldopen(3X) 
common object file function ldlread(3X) 
common object file symbol table/.. ..ldgetname(3X) 
common object file symbol table format. ....syms(4) 


.filehdr(4) 
.-glossary(1) 


common object files.... 
common operating system terms and. 
common to two sorted files.. 
communicate to a process. 
communication facilities status . 
communication package... 


compare or print out terminfo. 
compare RCS revisions... 
compare two files 
compare two versions of an SCCS file 
comparison... 
comparison 
comparison..... 
compatibility partitioning driver... 
COMPIIC...ssssssersseerersererseseeeeacenenencnes 
compile and execute regular expression. 
compile and match routines 


..cmpt(7) 
regemp(1) 
.regemp(3X) 
-regexp(5) 


compiled term file. ....term(4) 
compiler ee C and Lang Tools Binder 
compiler. 
compiler. 
compiler... 


compiler-compiler.. 
complementary error function 


compress an object file. see C and Lang Tools Binder 
compress and expand data compress(1) 
compress and expand files pack(1) 


compress(1) 
ldtbindex(3X) 


compress, uncompress, zcat: compress 
compute the index of a symbol table 


concatenate and print files.. ..-cat(1) 
condition evaluation comman .-test(1) 
config: build system configuration. onfig( 1M) 
configurable pathname variables. .pathcon{(2) 
configurable system variables syscon{{2) 
configuration device table dumpconf{(1M) 


mod_config(4) 
.Sys_config(4) 
..config( 1M) 
.. showefg(1M) 
-lpadmin(1M) 


configuration file... 
configuration file... 


configuration of the machine 
configure the LP print service. 
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- t_revconnect: receive the 


fwtmp, wtmpfix: manipulate 
t_accept: accept a 

t_listen: listen for a 

receive the confirmation from a 
establish an out-going terminal line 
data or expedited data sent over a 
send data or expedited data over a 
t_connect: establish a 

acctcon]l, acctcon2: 

dcheck: filesystem directory 
icheck: filesystem storage 

fsck: filesystem 

bomverify: perform an installation 
quotacheck: filesystem quota 
drivers 


console: 
consmem, sm, 8s: 


read_constab: read 

header for implementation-specific 
math: math functions and 

unistd: file header for symbolic 


constab: 
deroff: remove nroff, tbl, and eqn 
Uutry: try to 


Is: list 

sigcontext: get signal 

set and/or get signal stack 

esplit: 

sd: SCSI disk 

$ tm: SCSI tape 
ts: SCSI tape 

wd: SSM SCSI disk 

zd: dual-channel disk 

disk formatter for dual-channel disk 
synchronize a co-process with the 
virtually hangup the specified 


tty: 

_tolower, toascii: translate/ 

units: 

character classification and 

terminfo description captoinfo: 
dd: 

long integers 13tol, ltol3: 


base-64 ASCII string a64], 164a: 
dev_to_ttyname, ttyname_to_dev: 
/cftime, ascftime, mktime, tzset: 
ecvt, fevt, gevt: 


scanf, fscanf, sscanf: 
strtod, atof: 
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confirmation from a connect request... 
connect accounting records. 
CONNECL TEQUESE.....cssecereeereee 
connect request... 
connect request 


t_revconnect(3N) 
..fwtmp(1M) 
t_accept(3N) 
»t_listen(3N) 
__reveonnect(3N) 


RONMCCHON es sescscsiescssssasasciascsestaentntnecneaTaannne dial(3C) 
connection. ..t_rev(3N) 
connection .. .t_snd(3N) 


connection with another transport user 
connect-time accounting... 
consistency check.... 
consistency check... 
consistency check and interactive repai 
consistency check based on the BOM 
consistency Checker ......ececesssesesoees 
consmem, sm, ss: console memory 


.t_connect(3N) 
.acctcon(1M) 


.quotacheck(1M) 
...-consmem(7) 


console: console interface ...console(7) 
console interface.........0+ .console(7) 
console memory drivers .consmem(7) 
constab: constructed devices table. ..constab(4) 


constab entries into a structure 
constants..... 
constants... 
CONSLANLS......sessesseseeesneres 
constructed devices table. 
CONSETUCES ....eeereeseree eceee 
contact remote system with debugging on. 
contents of directory... 
context... 
context, 
context split... 
controller... 
controller... 
controller.... 
controller 
controller 
controller... 
controlling FMLI object... 
controlling terminal...... 


read_constab(3SEQ) 
...limits(4) 
«math(5) 


conv: toupper, tolower, _toupper, . 
conversion program 
conversion tables.... 


convert and copy & file......ssssssssesseres 
convert between 3-byte integers and 


convert between long integer and. a641(3C) 
convert major/minor numbers... dev_to_ttyname(3C) 
convert date and time to string.. .ctime(3C) 


convert floating-point number to string.. 
convert formatted input.........ccsssseccsesecees 
convert string to double-precision number 


ecvt(3C) 
.scanf{(3S) 
..Strtod(3C) 


Permuted Index 


strtol, atol, atoi: 
password file scheme pwunconv: 
vsig: synchronize a 
UNIX-to-UNIX system 
system file 

dd: convert and 
cpset: 

cpio: 

cp, In, mv: 

volcopy: make literal 
transfer 

savecore: save a 


core: format of 

mem, kmem: 

and unset environment variables in 
cocreate, cosend, cocheck, 

checkeq: check documents for 
trigonometric functions trig: sin, 
codestroy: communicate to/ cocreate, 
sinh, 

we: word 

sum: print checksum and block 
m_next: increment global 

usclk: 32-bit microsecond 


cpio: format of 


and group IDs 

clock: report 

cpus_online: returns the number of 
CPUs on-line 


an existing one 
setcolor: redefine or 
gence: 

tmpnam, tempnam: 
creat: 

fork: 

ctags: 

tmpfile: 

pipe: 

admin: 

tasktbl: 

setsid: 

pathconv: search Interpreter 


cronlog: 
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convert String to integer .......secssecscecesssseonteseecenensete 
converts from & tWO tO & ONC ..reeccesssesecosssearsee 
co-process with the controlling FMLI object. 


copy file and set mode, user, and group IDs.. 
copy file archives in and out 


copy, link or move files.. ..¢p(1) 
copy of filesystem. ..voleopy(1M) 
copy: perform a standalone data.....scsessesessearsencee copy(8) 
core dump of the operating system... savecore( 1M) 
core: format of core image file .core(4) 
core image file... .core(4) 
core memory mem(7) 
core or in files ...Set(1F) 
coreceive, codestroy: communicate to a/ .coproc(1F) 
.correct eqn syntax .checkeq(1) 
cos, tan, asin, acos, atan, atan2:. ..trig(3M) 
cosend, cocheck, coreceive, .coproc(1F) 
cosh, tanh: hyperbolic functions .«Sinh(3M) 


count of a file... 
counter... 
counter.. 
cp, In, mv: copy, link or move files 
cpio archive. 
cpio: copy file archives in and out. 
cpio: format of cpio archive.......00« 
cpp: C preprocessor. ..see C and Lang Tools Binder 
cprs: compress object file........see C and Lang Tools Binder 
cpset: copy file and set mode, user, cpset(1) 
CPU time used.. ..clock(3C) 
CPUs on-line... cpus_online(3PPS) 
cpus_online: returns the number of.......cpus_online(3PPS) 
crash: examine system images... .crash(1M) 


-m_next(3PPS) 
..usclk(7) 


creat: create a new file OF FEWTILC......sseessseeesereeseeeesee creat(2) 
create a color.. -setcolor(1F) 
create a front-end to the cc command.. .»..gence( 1M) 
create a name for a temporary file tmpnam(38) 
create a new file or rewrite an existing one.. creat(2) 


create a new process 
create a tags file... 
create a temporary file... 
create an interprocess channel 
create and administer SCCS files 
create security table in shared memory. 
create session and set process group ID.. 
criteria for filename 
cron: clock daemon 
cron history file....... 
cronlog: cron history file. 


.ctags(1) 
..tmpfile(3S) 
..pipe(2) 
admin(1) 
.tasktbl(1M) 
..Setsid(2) 
..pathconv(1F) 
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crontab: user 


exref: generate C program 
pg: file perusal filter for 


functions 
hashing encryption 
with C-like syntax 


terminal 
cftime, ascftime, mktime, tzset/ 


scr_dump: format of 
optimization package 

the user 

line of a file 

cut: 

cross-reference 
backup.codes: backup 
bdflush: update 

bdflush: update 

cron: clock 

strerr: STREAMS error logger 
crontabs: clock 
pwdhd: 
runacct: run 
300s: handle special functions of 
450: handle special functions of the 
zeat: compress and expand 

prof: display profile 

time a command; report process 
termcap: terminal capability 
diskusg: generate disk accounting 
t_revuderr: receive a unit 

sputl, sgetl: access long integer 
plock: lock process, text, or 

t_snd: send 

t_rev: receive 

t_snd: send data or expedited 
stat: 

brk, sbrk: change private 

shbrk, shsbrk: change shared 
brk, sbrk: change 

t_rev: receive data or expedited 
copy: perform a standalone 

types: primitive system 
t_revudata: receive a 

t_sndudata: send a 


creation 
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....crontab(1) 
crontab(1) 
.crontabs(4) 
see C and Lang Tools Binder 


crontab file ........:ssseseees 
crontab: user crontab file. 
crontabs: clock daemon file. 
cross-reference ... 


crypt: encode/decode. 
crypt: password and file encryption 
crypt, setkey, encrypt: generate...... 
csh: a shell (command interpreter). 
split: context Split......ssssesssseees 
ct: spawn getty to a remote terminal.. 
ctags: create a tags file.........4.. 
ctermid: generate filename for.. 


erypt(3C) 
...esh(1) 
-csplit(1) 
.ct(1C) 


ctime, localtime, gmtime, asctime,.. .ctime(3C) 
ctrace: C prog debugger.......... see C and Lang Tools Binder 
cu: call another UNIX system.. 
curses screen image file.......... 


curses: terminal screen handling and.. 
cuserid: get character login name of. 
cut: cut out selected fields of each.... 


cut out selected fields of each line of a file........ccssecoseee! cut(1) 
exref: generate C program.....see C and Lang Tools Binder 
cycle code definitions backup_codes(4) 


daemon... 
daemon 
daemon... 


-bdflush(1M) 


daemon... 

daemon file ......s.sesseeee ssbstsneeseresasertomes 

daemon to oversee password database. «pwdhd(1M) 
daily accounting......... es runacct(1M) 


DASI 300 and 300s terminals. 
DASI 450 terminal.. 


data prof(1) 
data and system activity... timex(1) 
data base.......... termeap(4) 


data by user ID diskusg(1M) 
data error indication.........ssessees __revuderr(3N) 
data in a machine-independent/ ..8put](3X) 
data in MEMOTY....ssccceeseceeeseees +e plock(2) 
data or expedited data over a connection.......00++ t_snd(3N) 


data or expedited data sent over a connection 
data over a connection 
data returned by stat system call .. 
data segment size... 
data segment size.... 
data segment space allocation 
data sent over a connection 
data transfer. 


_rev(3N) 
at. agri 


‘t _.sndudata(3N) 


Il 


Permuted Index 


diskinfo: disk device characteristic 
helpadm: change the Help Facility 
terminfo: terminal capability 

a terminal or query terminfo 
pwdhd: daemon to oversee password 
mkpwdbm: make a 

join: relational 

dbm_clearerr, dmb_blkflush: 
makewhatis: generate man page 
date: print and set the 

ascftime, mktime, tzset: convert 


/dbm_nextkey, dbm_error, 
dbm_delete,/ dbm_open, 
dbm_close, dbm_fetch, dbm_store, 
/dbm_firstkey, dbm_nextkey, 
dbm_firstkey,/dbm_open, dbm_close, 
/dbm_fetch, dbm_store, dbm_delete, 
dbm_store, dbm_delete, dbm_firstkey, 
dbm_store, dbm_delete/ 

dbm_open, dbm_close, dbm_fetch, 
pdbx, 


enable/disable patrol seeks on 
consistency check 


ctrace: C program 

pdbx, dbx: parallel 

try to contact remote system with 
crypt: encode/ 

timezone: set 

reset the current form field to its 
addusr.def: add user 

format disks or perform other 
gtty: set and get terminal state ( 
ut_add_user, ut_delete_user: add/ 
the delta commentary of an SCCS 
delta: make a 

cde: change the 

rmdel: remove a 

SCCS file 

comb: combine SCCS 

constructs 

whatis: 

close: close a file 

dup: duplicate an open file 

dup2: duplicate an open file 
setmntent: get file system 
getdtablemax: get maximum in-use 
getdtablesize: get 

setdtablesize: set 

de: 
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-dbm_firstkey, dbm_nextkey/. 


database.... 


database creation 
database for fast password lookup. 
database operator 
database subroutines... 
databases 


date and time to string.. 
date: print and set the date.. 
dbm_clearerr, dmb_blkflush: database, 
dbm_close, dbm_fetch, dbm_store,. 
dbm_delete, dbm_firstkey/.. 
dbm_error, dbm_clearerr,... 
dbm_fetch, dbm_store, dbm_delete 


dbm_nextkey, dbm_error/........ 
dbm_open, dbm_close, dbm_fetch, . 
dbm_store, dbm_delete, dbm _firstkey,/ 
dbx: parallel debugger. ..see C and Lang Tools Binder 
de: desk calculator 
DOC disks ivcsssssssssssessssesaccvenasiee 
dcheck: filesystem directory. 
dd: convert and copy a file. 


debugger... see C and Lang Tools Binder 
debugger.... .see C and Lang Tools Binder 
debugging on. <uutry(1M) 
QRC0 OR iicccinicmnimnnnnnonmamnnmanmmemmnae crypt(1) 


..timezone(4) 
..reset(1F) 
..addusr_def(4) 
..format(1M) 

saaacee stty(2) 
.utadduser(3X) 
...cde(1) 
.delta(1) 


default system time zone... 
default values. 
defaults... 
defect management functions... 
RTT CE) ccnsascsoscsnsscaossnssiecacssan 
delete users in utmp file. 


delta (change) to an SCCS file 
delta commentary of an SCCS delta 


delta from an SCCS file.........+. rmdel(1) 
delta: make a delta (change) to an. delta(1) 
Ge lta si scissisynssesesvsasesressraracnrneenees comb(1) 


deroff: remove nroff, tbl, and eqn. 
describe what a command is. 


descriptor... close(2) 
descriptor ...dup(2) 
descriptor. “dup2(2) 
descriptor file entry .. ..getmntent(3SEQ) 
descriptor table index... getdtablemax(2SEQ) 
descriptor table size. getdtablesize(2SEQ) 
descriptor table size. ....setdtablesize(2SEQ) 
Peskical Cal ator ssssccssexescesosccrocsscccusstosusesserasacentacsareesessctestes de(1) 
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devbuild, devdestroy: build and 
destroy virtual devices 

virtual devices devbuild, 
ioctl: control 

prtvtoc: print the VTOC of a block 
print the VTOC of a standalone disk 
sp: STREAMS pipe 

or the terminal associated with a 
the terminal/ ttydevname: get the 
diskinfo: disk 

devnm: 

clone: open any minor 

devtab: virtual 

dump kernel auto-configuration 


destroy virtual devices. 
devbuild, devdestroy: build and. 
devdestroy: build and destroy... 
device... 


.devbuild(1M) 
.devbuild(1M) 
.devbuild(1M) 


device associated with a terminal or.. 
device characteristic database.. 
AeVvice NAME.......sscsssscecsssereeceees 
device on a STREAMS driver.. 
device table. 
device table. 


backup.dev: backup devices.......... _ 
build and destroy virtual devices... .devbuild(1M) 
of virtual-to-physical mapping devices. .«pmap(1M) 
SA: devices administered by System Administration......... sa(7) 


constab: constructed 


convert between major/minor numbers/ 
blocks and inodes 

dmesg: collect system 

SCED: ScSl/Ethernet/ 

terminal line connection 

bdiff: big 


comparison 
sdiff: suas a 


dir: format of 

unlink: link and unlink files and 
mkdir: make 

rm, rmdir: remove files or 
uucheck: check the uucp 

ced: change working 

chdir: change working 

chroot: change root 

get pathname of current working 
system level transition files 

Is: list contents of 

mkdir: make a 

mvdir: move a 

rmdir: remove a 

uucleanup: uucp spool 

dircmp: 

dcheck: filesystem 

system independent/ getdents: read 
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devices table. 


sscdsaaacestiest sssssersseeseesesenoCOnStab(4) 
-devnm(1M) 
....devtab(4) 
dev_to_ttyname(3C) 


devtab: virtual device table 
dev_to_ttyname, ttyname_to_dev:. 
df: report number of free disk.... 
diagnostic messages to form error log 
Diagnostics board... 
dial: establish an out-going 


diff: differential file comparison 
diff3: 3-way differential file 
difference program... 
differential file comparison. 
differential file comparison. 
dir: format of directories..... 


directory clean-up...... 
directory comparison. 
directory consistency check 


directory entries and put in a file... .getdents(2) 
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dirent: file system independent 
unlink: remove 

chroot: change root 

pwd: working 

telldir, seekdir, rewinddir/ 
seekdir, rewinddir, closedir: 
mknod: make a 

directory entry 

basename, 


instructions 

t_unbind: 

enable, 

enable, disable: enable/ 

sweepon, sweepoff: enable/ 

acct: enable or 

swapping, or processor migration 
dis386: 

dis: object code 

t_revdis: retrieve information from 
t_snddis: send user-initiated 

installs a boot program on a 

diskusg: generate 

df: report number of free 

sd: SCSI 

wd: SSM SCSI 

zd: dual-channel 

disk formatter for dual-channel 
print the VTOC of a standalone 
diskinfo: 

CCSformat: standalone embedded SCSI 
controller zdformat: standalone 
getgeombyname: get 

quotactl: manipulate 

du: summarize 

quota: display 

database 

mkvtoc: populate VTOC on 
enable/disable patrol seeks on DCC 
mgmt functions format: format 
data by user ID 
indicator: 
quota: 

vi: screen-oriented (visual) 

man: 

virtual-to-physical mapping/ pmap: 
prof: 

bootflags: 

hypot: Euclidean 


and/or the working/ 


/dbm_error, dbm_clearerr, 
messages to form error log 
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directory entry.... 
directory entry.. 
directory for a comman 
directory NAME... 
directory: opendir, readdir, 
directory operations.... 
directory, or a special or ordinary file 
dirent: file system independent........... 
dirname: deliver portions of pathnames 
dis: code disassembler............ see C and Lang Tools Binder 
dis386: disassemble Series 386. .dis386(3SEQ) 
disable a transport endpoint... _unbind(3N) 
disable: enable/disable LP printers. ri 

disable LP printers 
disable patrol seeks on DCC disks. 
disable process accounting. 


wees acct(2) 
noage(1M) 
disassemble Series 386 instructions... .dis386(3SEQ) 
disassembler. see C and Lang Tools Binder 
disconnect...... .ut_revdis(3N) 
disconnect request. t_snddis(3N) 


disk accounting data by user ID 
disk blocks and inodes.. 
disk controller... 


disk controller 
disk device...... 
disk device characteristic database. 
disk formatter... 
disk formatter for dua 


ccsformat(8) 
on saree 


diskinfo: disk device characteristic. 
disks... 
disks... 
disks or perform other defect 
diskusg: generate disk accounting 
display application specific alarms... 
display disk usage and limits 
display editor based on ex.. 
display on-line man pages... 
display or alter parameters o. 
display profile data... 
display/change system boo 
distance function ......ssscssascecssens 
ditsectbl: refresh security table 
dmb_blkflush: database subroutines... 
dmesg: collect system diagnostic....... 


-bootflags(1M) 
... hypot(3M) 
-dltsectbl(1M) 
.-ndbm(3X) 
.dmesg{(1M) 
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checkeq: check 

pretmp/ chargefee, ckpacct, 
strtod, atof: convert string to 
mrand48, jrand48, srand48, seed48/ 
open any minor device on a STREAMS 
cmpt: compatibility partitioning 

cn: pseudoconsole 

terminal multiplexor 

streampty: STREAMS pseudo terminal 
vtoc: VTOC partitioning 

Xylogics 781 terminal multiplexor 
streamtty: Generic STREAMS tty 
consmem, sm, ss: console memory 


zd: 

/standalone disk formatter for 
dump: incremental filesystem 

dump: standalone memory 

od: octal 

of an object file 

format 

dumpfs: 

dump, dumpdates: incremental 
device table dumpconf: 
savecore: save a core 


auto-configuration device table 
dump, 


descriptor 
descriptor 
dup: 
dup2: 


echo: 


floating-point number to string 


end, etext, 

command 

casual users) 

edquota: 

sact: print current SCCS file 

ed, red: text 

ex: text 

sed: stream 

vi: screen-oriented (visual) display 
1d: link 

a.out: common assembler and link 
edit: text 
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documents for correct eqn syntax....... 
dodisk, lastlogin, monacct, nulladm 
double-precision number........ deserinne 
drand48, erand48, lrand48, nrand48, 


du: summarize disk usage.. 
dual-channel disk controller... 
dual-channel disk controller... 


dump: dump parts. 
dump, dumpdates: incremental dump. 
dump filesystem information .. 
dump format... 
dump: incrementa’ 
dump kernel auto-configuration 
dump of the operating system... 
dump: standalone memory dump... 
dumpconf: dump kernel........... vase 
dumpdates: incremental dump format 
dumpfs: dump filesystem information... 
dup: duplicate an open file... 
dup2: duplicate an open file 
duplicate an open file descriptor 
duplicate an open file descriptor 
ec: forms compiler... 
echo arguments...... 
echo: echo arguments 
echo: put string on virtual output... 
ecvt, fevt, BCVt: CONVETT.....ssecesceeesee 
ed, red: text Editor .....csesesscceeeeseen 
edata: last locations in program 
ede: run an externally described.. 
edit: text editor (variant of ex for. 
edit user quotas 
editing activity. 
editor... 
editor.. 
editor... 
editor based on e 
editor for object files 
editor output. 
editor (variant of ex for casual users)... 


Permuted Index 


effective user, real group, and 
/getgid, getegid: get real user, 


fsplit: split f77, ratfor, or 

using full regular expressions 
CCSformat: standalone 

printers 

acct: 

enable, disable: 

sweepon, sweepoff: 

crypt: 

crypt, setkey, 

setkey, encrypt: generate hashing 
crypt: password and file 
makekey: generate 

program 

gence: create a front- 

/getgrgid, getgrnam, setgrent, 
setmntent: get file/ addmntent, 
bind an address to a transport 
t_close: close a transport 

at the current event on a transport 
t_open: establish a transport 
manage options for a transport 
t_unbind: disable a transport 
/getpwuid, getpwnam, setpwent, 
getspent, getspnam, setspent, 
/getutline, pututline, setutent, 
mailbug: submit a bug report or 
execution 

files 


environ: user 

putenv: change or add value to 
commands performed for multi-user 
profile: setting up an 

fpsetsticky: IEEE floating-point 

env: set 

getenv: return value for 

set, unset: set and unset 

deroff: remove nroff, tbl, and 
checkeq: check documents for correct 
jrand48, srand48, seed48,/ drand48, 
complementary error function 
complementary error function —_erf, 
error messages perror, 
error function and complementary 
error function erf, erfe: 
t_revuderr: receive a unit data 
system diagnostic messages to form 
errorlog: internal 
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edquota: edit user quotas 
effective group IDs.... 
effective user, real group, and/. 


- getuid(2) 
getuid(2) 


efi: Extended Fortran Language.. ..efl(1) 
CH Rle8 wn. cnsssosescasesesescsessusassseasiesuis .-fsplit(1) 
egrep: search a file for a pattern. .egrep(1) 
embedded SCSI disk formatter..... .ccsformat(8) 
enable, disable: enable/disable LP. ...enable(1) 
enable or disable process accounting. +e 8008 (2) 
enable/disable LP printers.........s0000 enable(1) 


enable/disable patrol seeks on DCC disks 


encode/decode..... ..crypt(1) 
encrypt: generate hashing encryption crypt(3C) 
ENCTYPtiON ....sesesesseeee crypt(3C) 
encryption functions. crypt(3X) 
ENCTYPtion Key...esssreccseecesseerersenceees «.makekey(1) 


end, etext, edata: last locations i0.....ssssssscsesseseeeees end(3C) 


-end to the cc command. .gence( 1M) 
endgrent, fgetgrent: get group file entry........... getgrent(3C) 
endmntent, getmntent, hasmntopt, ..getmntent(83SEQ) 
endpoint... ...t_bind(3N) 
endpoint t_close(3N) 
endpoint t_look(3N) 
endpoint t_open(3N) 


endpoint. __optmgmt(3N) 


Grid POM ssssissccssusasvasssscesusceanssacasavesscancetasteess ..t_unbind(3N) 
endpwent, fgetpwent: get password file’.........getpwent(3C) 
endspent, fgetspent, Ickpwdf/.......000+ getspent(3X) 
endutent, utmpname, getutpid: access/. ..getut(3C) 
enhancement request..essssscssesesseseees 


env: set environment for command. 
-environ, .pref, .variables: FACE... 


environ: user environment. environ(5) 


environment.. environ(5) 
environment 

environment 

environment at login time.. profile(4) 
environment control..........++ pgetround(3C) 
environment for command exccution.. .env(1) 
ENVITONMENt NAME .......e.essseseeeseecereoes getenv(3C) 


environment variables in core or in files. 
eqn constructs 
eqn syntax. 

erand48, lrand48, nrand48, mrand48, 
erf, erfc: error function and. 
erfe: error function and. 
errno, sys_errlist, sys_nerr: system . 
CYTOL FUNCLION.....sscssceeceeecasensetcceeeoes 
error function and complementary. 
error indication. 
error log...... 
error log file... 


drand48(3C) 
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edquota(1M) © 


strelean: STREAMS 

strerr: STREAMS 

log: interface to STREAMS 

t_error: produce 

errormsg: 

errno, sys_errlist, sys_nerr: system 
introduction to system calls and 
matherr: 


spellin, hashcheck: find spelling 
/etc/shadow with information from / 
pwconv: installs and updates / 
end, 

SCED: scsl/ 

hypot: 

expr: 

test: condition 

t_look: look at the current 

to STREAMS error logging and 
sulog: log of substitute user 
(visual) display editor based on 
edit: text editor (variant of 


execlp, execvp: execute a file 
execlp, execvp: execute a/ exec: 
exec: execl, execv, 

exec: execl, execv, execle, execve, 
run: run an 

execle, execve, execlp, execvp: 
m_fork: 

construct argument list(s) and 

at, batch: 

regemp, regex: compile and 

uuxqt: 

env: set environment for command 
suspend and resume child process 
/system command 

sleep: suspend 

sleep: suspend 

monitor: prepare 

profil: 

execvp: execute a file exec: execl, 
exec: execl, execv, execle, 

execv, execle, execve, execlp, 


exit, 

exponential, logarithm, power, 
uncompress, zcat: compress and 
pack, peat, unpack: compress and 
exp, log, log10, pow, sqrt: 
expression 
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error logger cleanup program. 
error logger daemon...........++ 
error logging and event tracing 
error message... 
error message text file 
error messages 
error numbers 


errorlog: internal error log file 
errormsg: error message text file... 


“errormsg(4) 
— spell(1) 


errors ....... 
etc/passwd... «pweonv( 1M) 
etc/shadow with information fro: .pweonv( 1M) 
etext, edata: last locations in program.....sesersssseeee or 


Ethernet/Diagnostics board. 
Euclidean distance function. 
evaluate arguments as an expression.. 
evaluation command. 
event on a transport endpoint. 
event tracing.. 
events. 


ex for casual users).. 
ex: text editor... 
exec: execl, execv, execle, execve, 
execl, execv, execle, execve,, 
execle, execve, execlp, execvp: execute a file.. 
execlp, execvp: execute a file 
executable.... 
execute a file 
execute a subprogram in parallel. 
execute command. 
execute commands at a later time.. 
execute regular expression 
execute remote command requests 
execution... 
execution 
execution ... 
execution for an interval.. 
execution for interval. 
execution profile...... 
execution time profile... 
execv, execle, execve, execlp,. 
execve, execlp, execvp: execute a file . 
execvp: execute a file............ 
exit, _exit: terminate process. 
_exit: terminate process... 
exp, log, log10, pow, sqrt: 
expand data 
expand files... 
exponential, logarithm, power, square/. 
expr: evaluate arguments as an... 


m_park_procs(3PPS) 
..uux(1C) 
sleep(1) 
sleep(3C) 
.-monitor(3C) 
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expr: evaluate arguments as an 
regex: compile and execute regular 
regemp: regular 

regexp: regular 

for a pattern using full regular 

efi: 

ede: run an 

fsplit: split 

floor, ceil, fmod, 

pathalias: alias file for 

.environ, .pref, .variables: 

report inter-process communication 
a number 

factor: obtain the prime 

true, 

abort: generate an IOT 

stream 


ecvt, 

fopen, freopen, 
ferror, 
stream status inquiries 

for a filesystem 

felose, 

from a stream getc, getchar, 
/getgrnam, setgrent, endgrent, 
/getpwnam, setpwent, endpwent, 
gets, 

/getspnam, setspent, endspent, 
string 

cut: cut out selected 

mkfifo: make a 

access: determine accessibility of a 
chmod: change mode of 

chown: change owner and group of a 
core: format of core image 

cronlog: cron history 

crontab: user crontab 

crontabs: clock daemon 

ctags: create a tags 

selected fields of each line of a 

dd: convert and copy a 

make a delta (change) to an SCCS 
errorlog: internal error log 
errormsg: error message text 
execve, execlp, execvp: execute a 
get: get a version of an SCCS 
group: group 

issue: issue identification 

header of a member of an archive 
ldaclose: close a common object 


number to string 


18 


-fentl: file contro] .......cseseoe 


expression.... 
expression... 
expression compile. 
expression compile and match routines 
expressions. 
Extended Fortran Language.... 
externally described command 
f77, ratfor, or efi files aa 
fabs: floor, ceiling, remainder, absolute value”...... 


facilities status... 
factor: obtain the prime factors o 
factors of a number.......... 
false: provide truth values... 


..fclose(3S) 
..fentl(2) 
fentl(5) 
.ecvt(3C) 
..fopen(3S) 
ferror(3S) 
.ferror(3S) 
eveff(1M) 


fclose, fflush: close or flush a... 


fentl: file control options... 
fevt, gcvt: convert floating-point! 
fdopen: open & StreaM.....+.ese00 
feof, clearerr, fileno: stream status inquiries 
ferror, feof, clearerr, fileno...... 
ff: list filenames and statistics... 
fflush: close or flush a stream.... 
fgetc, getw: get character or word 
fgetgrent: get group file entry....... 
fgetpwent: get password file entry 
fgets: get a string from a stream... 
fgetspent, Ickpwdf, ulckpwdf: get/ 
fgrep: search a file for a character 
fields of each line of a file 

FIFO special file 

file.... 

file .... 

file. 

file. 

file.. 


.ldahread(3X) 
Idclose(3X) 
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the file header of a common object 
of a section of a common object 


.ldfhread(3X) 


file header of a common object Idohseek(3X) 

of a section of a common object ... ldrseek(3X) 
section header of a common object Jdshread(3X) 
section of a common object ...ldsseek(3X) 

table entry of a common object .ldtbindex(3X) 


table entry of a common object 
the symbol table of a common object 
number entries in a common object 


.ldtbread(3X) 
.ldtbseek(3X) 


DIBA 05 Ol iG cssesssersccncsesecssancasrassncencssenaasercctevmrteraitsasscanesceaienciasts Jink(2) 

mkfifo: make a FIFO special mk fifo(3C) 
mknod: build special mknod(1M) 

directory, or a special or ordinary mknod(2) 


format of a module configuration mod_config(4) 


motd: message-of-the-day motd(4) 

newform: change the format of a text newform(1) 
null: the null ..-null(7) 

passwd: password ~passwd(4) 

files or subsequent lines of one -paste(1) 
product: installed products product(4) 

PIS! PrintianiSCCS file isci.sessssssasseaccanssarsessssecssacssrspuscessysassnssertesssaesesaava ise prs(1) 

resfile: format of RCS resfile(4) 

read: read from read(2) 


readv: read vector from readv(2SEQ) 
reinit: run an initialization I 


information for a common object ..reloc(4) 
rename: change the name of a .rename(2) 
rmdel: remove a delta from an SCCS rmdel(1) 
compare two versions of an SCCS  secsdiff{1) 
scesfile: format of SCCS ..sccsfile(4) 

sccstorcs: build RCS file from SCCS secstorcs(1) 
section header for a common object .8cnhdr(4) 
format of curses screen image -scr_dump(4) 
shadow: restricted password -shadow(4) 

system shutdown information .shutdown(4) 
spellhist: unmatched spelling words spellhist(4) 
print checksumiand block countf'a Ole a sssccsssscccssescassaccsssessssssniesaissancesssveisenteniscanordeorciantennsses sum(1) 


symlink: make symbolic link to a symlink(2SEQ) 
format of a system configuration -sys_config(4) 


tailideliverithe/last partiols: file ssicscssasscssssviscsconsssadscsasscingecutsndsianstsissscectccssostnnaissseaiiess tail(1) 
term: format of compiled term .term(4) 
tmpfile: create a temporary tmpfile(3S) 
create a name for a temporary tmpnam(3S) 
access and modification times of a -touch(1) 
undo a previous get of an SCCS unget(1) 
uniq: report repeated lines in a .-uniq(1) 
add/delete users in utmp -utadduser(3X) 

the uuep directories and permissions uucheck(1M) 
Walz'validate SCCS: (fe cesisasjssscscasssauccassssscarencasenciuarcesssusticbssacccstesmtessseateyaitael val(1) 

write: write on a . write(2) 

writev: write vector on a er .. writev(2SEQ) 


DYNIX/ptx Reference Manual 19 


Permuted Index 


utime: set 

ldfen: common object 
readfile, longline: reads 
cpset: copy 

Hewlett-Packard 2645A terminal tape 
tar: tape 

cpio: copy 

res: change RCS 

pwek, grpck: password/group 
mcs: manipulate the object 
diff: differential 

diff8: 3-way differential 
fentl: 

fentl: 

UNIX-to-UNIX system 
umask: set and get 

close: close a 

dup: duplicate an open 

dup2: duplicate an open 


sact: print current SCCS 

crypt: password and 

endgrent, fgetgrent: get group 

get file system descriptor 
endpwent, fgetpwent: get password 
ulckpwdf: get shadow password 
utmpname, getutpid: access utmp 
putpwent: write password 
putspent: write shadow password 
fgrep: search a 

grep: search a 

egrep: search a 

proto: prototype job 

pathalias: alias 

ldaopen: open a common object 
acct: per-process accounting 

ar: common archive 

manager, updates text files in ISIS 
intro: introduction to 

scestorcs: build RCS 

number entries of a common object 
filehdr: 

limits: 

unistd: 

ldfhread: read the 

Idohseek: seek to the optional 
split: split a 

mmap: map an open 
isismgr: ISIS 
merge: three-way 
ttyslot: find the slot in the utmp 
more: view a 


ISIS file format 
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file access and modification times... 
file access routines 
file and gets longest line. 
file and set mode, user, and group IDs.. 
file archiver... 
file archiver... 
file archives in and out 
file attributes... 
file checkers... 
file comment section... 
file comparison... 


file control options. 
file COPY...sesseeseseees 
file creation mask. 
file descriptor.. 
file descriptor. 
file descriptor... 
file: determine file type 
file editing activity... 
file encryption functions.. 
file entry... 
file entry.. 
file entry. 
file entry..... 
file entry... 
file entry 
file entry.... 
file for a character string. 
file for a pattern ....csoeee 
file for a pattern using full regular expressions. 
file for at... 
file for FAC! 
file for reading.. 


" .dup(2) 
.-file(1) 


file format 
file format... see C and Lang Tools Binder 
file format.. isismgr(1M) 


asi intro(4) 
..secstorcs(1) 
..1dlread(3X) 


file header for common object files 
file header for implementation-specific/.. 
file header for symbolic constants.... 
file header of a common object file. 
file header of a common object file... 
file into pieces 
file into the processs address spac 
file manager, updates text files in 
file merge..........0+ 
file of the current user. 
file one full screen at a time 
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fuser: identify processes using a 
creat: create a new 

Pe: 

lseek: move read/write 

fseek, rewind, ftell: reposition a 
bfs: big 

from a two to a one password 

stat, Istat, fstat: get 

identify processes using a file or 
symbol name for common object 
syms: common object 

newfs: construct a new 

/read directory entries and put ina 
/getmntent, hasmntopt, setmntent: get 
dirent: 
fs, inode: format of 

truncate, ftruncate: truncate a 
uusched: the scheduler for the uucp 
uucico: 

ftw: walk a 

file: determine 

umask: set 

object files 

mktemp: make a unique 
search Interpreter criteria for 
ctermid: generate 
ff: list 

ferror, feof, clearerr, 
search and print process accounting 
merge or add total accounting 
admin: create and administer SCCS 
cat: concatenate and print 
cmp: compare two 
or reject lines common to two sorted 
config: build system configuration 
cp, ln, mv: copy, link or move 
environ, .pref, .variables: FACE 
file header for common object 
find: find 
fspec: format specification in text 
fsplit: split 77, ratfor, or efi 
string, format of graphical 
ident: identify 
intro: introduction to special 
lockf: record locking on 
makedev: make system special 
peat, unpack: compress and expand 
pr: print 
and other information about RCS 
environment variables in core or in 
sort: sort and/or merge 
uucp: networking support 
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file or file structure. ..fuser(1M) 
file or rewrite an existing one... ..creat(2) 
file perusal filter for CRTs. --Pg(1) 
file pointer .......ssecsee -Iseek(2) 


file pointer in a stream. 
file scanner... 
file scheme 
file status.. 


file symbol table entry. 
file symbol table format 
file system .......s.sscscessseeee 
file system independent format... 
file system descriptor file entry... 
file system independent directory entry. 
file system VolUME .......esssesssesseeseceseeses ce 
file to a specified length.. 


file transport program... es 

file transport program for the uucp system........uucico(1M) 
file tree........sssseee ee anions .ftw(3C) 
HG EY PO sisnsssecncccanssacseseansacs -file(1) 


file-creation mode mask. «umask(1) 


filehdr: file header for common.. -filehdr(4) 
Alen aMeE a. ssiscsieccesssccsseees mktemp(3C) 
filename... .pathconv( 1F) 
filename for termina’ ctermid(3S) 
filenames and statistics for a filesystem ......sse-sssseseees f(1M) 
fileno: stream status inquirie ferror(3S) 


..fspec(4) 
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what: identify SCCS 

link, unlink: link and unlink 
init.d: system level transition 
ISIS file manager, updates text 
passmgmt: password 

rm, rmdir: remove 

paste: merge same lines of several 
ott: 

checkfsys: check a 

list filenames and statistics for a 
mkfs: construct a 

mount: mount a 

repquota: summarize quotas for a 
tunefs: tune up an existing 
umount: unmount a 

volcopy: make literal copy of 
ckbupscd: check 
fsck: 

dcheck: 

dump: incremental 
fstyp: determine 
dumpfs: dump 
statfs, fstatfs: get 
quotacheck: 
quotaon, quotaoff: turn 

restore: incremental 

ustat: get 

fsstat: report 

icheck: 

mnttab: mounted 

labelit: provide labels for 

mount, umount: mount and unmount 
umountall: mount, unmount multiple 
checklist: list of 

fstab: 

greek: select terminal 

nl: line numbering 

pg: file perusal 

col: 

Ipfilter: administer 


interactive repair 


for an object library lorder: 
display/change system boot 
/fpgetsticky, fpsetsticky: IEEE 
isnan: isnand, isnanf: test for 

ecvt, fevt, gevt: convert 

ldexp, modf: manipulate parts of 
ceiling, remainder, absolute value/ 
floor, ceil, fmod, fabs: 

fclose, flush: close or 

a co-process with the controlling 
floor, ceil, 
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. filesystem consistency check and... 


files in ISIS file format. 
files management 
files or directories 
files or subsequent lines of one/.. 
files that hold object architecture information. 


Ml eB Y Stern 5 ss:cscescssccsevssaccestutsesersines 

filesystem. 

filesystem. ..mkfs(1M) 
filesystem... ...mount(2) 
filesystem. repquota(1M) 
filesystem. tunefs(1M) 
filesystem umount(2) 
filesystem... -voleopy(1M) 


filesystem backup schedule .ckbupsced(1M) 
.fsck(1M) 
filesystem directory consistency chec! 
filesystem dump....... 
filesystem identifier. 


filesystem information... -dumpfs(1M) 


filesystem information......scssssssscssesseneesecesenorseenees statfs(2) 
filesystem quota consistency checker.........quotacheck(1M) 
quotaon(1M) 

filesystem restore. -restore(1M) 
filesystem statistics. -Ustat(2) 
filesystem status....... fsstat(1M) 
filesystem storage consistency check .. icheck(1M) 
filesystem table. mnttab(4) 
filesystems... -labelit(1M) 
filesystems... -mount(1M) 
filesystems.. mounta)l(1M) 
filesystems processed by fsck and ncheck...........checklist(4) 
.-fstab(4) 


file-system-table 


filter for CRTs. 
filter reverse line-feeds. 
filters used with the LP print service. 
find: find files 
find ordering relation 
flags 
floating-point environment control... 
floating-point NaN (Not-A-Number) 
floating-point number to string. 
floating-point numbers.. 
floor, ceil, fmod, fabs: floor,.. 
floor, ceiling, remainder, absolute value/. 
flush a stream... 
FMLI object... 
fmod, fabs: floor, ceiling, remainder, absolu 


see C and Lang Tools Binder 
.... boot flags(1M) 
.{pgetround(3C) 
isnan(3C) 
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stream 


tcgetpgrp: get 
tcsetpgrp: set 


system diagnostic messages to 

reset: reset the current 

acct: per-process accounting file 
dump, dumpdates: incremental dump 
put in a file system independent 
updates text files in ISIS file 
common object file symbol table 
management functions format: 
other defect management functions 
mod_config: 

sys_config: 

newform: change the 


fs, inode: 

gps: graphical primitive string, 
resfile: 

scesfile: 

fspec: 

strftime: 

intro: introduction to file 

utmp, wtmp: utmp and wtmp entry 
scanf, fscanf, sscanf: convert 

printf, fprintf, sprintf: print 
vprintf, vfprintf, vsprintf: print 
pwfix: remove incorrectly 
standalone embedded SCSI disk 
zdformat: standalone disk 
ASSIST menus or command 
ec: 

lpforms: administer 
addformopt: add a 

ratfor: rational 

efi: Extended 

pathconf, 

fpgetround, fpsetround, 
fpsetmask, fpgetsticky/ 
/fpsetround, fpgetmask, fpsetmask, 


variables 


printf, 
fpgetround, fpsetround, fpgetmask, 
fpgetsticky/ fpgetround, 


/fpgetmask, fpsetmask, fpgetsticky, 
pute, putchar, 

puts, 

getfrm: returns the current 
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: format of curses screen image file 


fopen, freopen, fdopen: open a.... .-.fopen(3S) 


foreground process group ID... getpgrp(2) 
foreground process group ID .tesetpgrp(2) 
fork: create a new process. fork(2) 
form error 1Og.....sesecesseonssesseessaseen 


form field to its default values.. 


.-format(1M) 
..format(1M) 
-mod_config(4) 
sys_config(4) 
.newform(1) 


format of a module configuration file.. 
format of a system configuration file 
format of a text file.........00 
format of compiled term file 
format of core image file.. 
format of cpio archive... 


format of directories... .dir(4) 
format of file system volume.. fs(4) 
format of graphical files .gps(4) 
format of RCS file........... resfile(4) 
format of SCCS file... sccsfile(4) 
format specification in text files 


format time information .......00 
formats... 
formats... 
formatted input 
formatted output... 
formatted output of a varargys/.... 
formatted password entries 
formatter... 


forms compiler. 
forms used with the LP print Service....s....cseeere lpforms(1M) 
form/SELECT window option to a menu.....addformopt(1M) 
Fortran dialect... ratfor(1) 
Fortran Language .. 
fpathconf: get configurable pathname. 
fpgetmask, fpsetmask, fpgetsticky,/. 
fpgetround, fpsetround, fpgetmask, . 
fpgetsticky, fpsetsticky: IEEE/....... 


.-pathcon{(2) 
..fpgetround(3C) 
..fpgetround(3C) 
..fpgetround(3C) 


fprintf, sprintf: print formatted output... print{(3S) 
fpsetmask, fpgetsticky, fpsetsticky/ ..fpgetround(3C) 
fpsetround, fpgetmask, fpsetmask., ... .-fpgetround(3C) 
fpsetsticky: IEEE floating-point/.... ..fpgetround(3C) 


fputc, putw: put character or word on a stream.....putc(3S) 
fputs: put a string on a stream a 
frame number 


Permuted Index 


t_free: 

df: report number of 

malloc, 

mallinfo: fast main memory/ malloc, 
fopen, 

of floating-point numbers 
gence: create a 

volume 

scanf, 

list of filesystems processed by 
and interactive repair 

file pointer in a stream 
generation numbers 

files 

files 


stat, Istat, 

statfs, 

identifier 

fseek, rewind, 

communication package stdipe: 
specified length truncate, 


function and complementary error 
gamma: log gamma 

hypot: Euclidean distance 

entries of a common object file 
matherr: error-handling 

prof: profile within a 

erf, erfc: error 

jo, j1, jn, y0, yl, yn: Bessel 

crypt: password and file encryption 
logarithm, power, square root 
ceiling, remainder, absolute value 
or perform other defect management 
sinh, cosh, tanh: hyperbolic 
sysi86: machine specific 

keys to internal menu system 
acos, atan, atan2: trigonometric 
math: math 

intro: introduction to 

300, 300s: handle special 

hp: handle special 

450: handle special 

file or file structure 

specified controlling terminal 
fread, 

accounting records 

gamma: log 
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stab: file-system-table 


fread, fwrite: binary input/output 
free a library structure 
free disk blocks and inodes. 
free, realloc, calloc: main memory allocator. 
free, realloc, calloc, mallopt,. 
freopen, fdopen: open a stream 
frexp, ldexp, modf: manipulate parts... 
front-end to the cc command...... 


fs, inode: format of file SySteM.........cscsccocecsensncnsorersereeeoree fs(4) 
fscanf, sscanf: convert formatted inpu' scan{(3S) 
fack and ncheck........cs.cccsesesesseseereees checklist(4) 
fsck: filesystem consistency check fsck(1M) 
fseek, rewind, ftell: reposition a.. ..fseek(3S) 
fsirand: install random inode.... fsirand(1M) 
fspec: format specification in text.. fspec(4) 
fsplit: split [77, ratfor, or efl.... fsplit(1) 


fsstat: report filesystem status 


: stat(2) 


fstat: get file status 
fstatfs: get filesystem information. 
fstyp: determine filesystem..........+« 
ftell: reposition a file pointer in a stream 
ftok: standard interprocess..... 
ftruncate: truncate a file to a.. 
fiw: walk a file tree 
function... 
function. 
function... 


statfs(2) 
.fstyp(1M) 
.fseek(3S) 


function “Idlread(3X) 
function -matherr(3M) 
function... 


function and complementary error function... 
functions. 
functions... 
functions... 
functions... 
functions.. 
functions... 
functions. 
functions... 
functions. 
functions and constants. 
functions and libraries. 
functions of DASI 300 and 300s terminals 
functions of Hewlett-Packard terminals... 
functions of the DASI 450 terminal. 
fuser: identify processes using a. 
fvhangup: virtually hangup the 


format(1M) 
-sinh(3M) 
-sysi86(2) 


“fvhangup(2SEQ) 


fwrite: binary input/output .......seccsserssesssenecsernearens fread(3S) 
fwtmp, wtmpfix: manipulate connect. ..fwtmp(1M) 
gamma function. -gamma(3M) 
gamma: log gamma function. -gamma(3M) 
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ecvt, fevt, 

command 

command forms astgen: program for 
fsirand: install random inode 

rand, srand; simple random-number 
streamtty: 

tty: controlling terminal 
getgeombyname: get disk 

character or word from a stream 

or word from a stream gete, 
working directory 

put ina file system independent/ 
descriptor table index 


size 

getuid, geteuid, getgid, 

name 

user, effective user, real/ getuid, 
number 


geometry by name 
getuid, geteuid, 
ee" endgrent, fgetgrent: get/ 


endgrent, fgetgrent: get/  getgrent, 
fgetgrent: get/ _— getgrent, getgrgid, 
IDs 


currently marked menu items 


file system/ addmntent, endmntent, 
stream 
argument vector 


getopts, 
options 


process group, and parent/ __getpid, 
process, process group, and parent/ 
and parent process/ getpid, getpgrp, 
utilization information 


setpwent, endpwent, fgetpwent: get/ 
fgetpwent: get/ getpwent, getpwuid, 
endpwent, fgetpwent: get/ getpwent, 
stream 

readfile, longline: reads file and 
scsiinfo structure 


getscsiinfo, 
endspent, fgetspent, Ickpwdf/ 
fgetspent, Ickpwdf/ getspent, 


speed and terminal settings used by 
speed, and line discipline 
ct: spawn 
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gcvt: convert floating-point number to string 
gence: create a front-end to the cc 
generating/modifying ASSIST menus or... 
generation numbers. 
BENECTALOL .....ereceeeeoees 
Generic STREAMS tty driver interface. 
(gentty) interface.... 
geometry by name.. 
getc, getchar, fgetc, getw: get.. 
getchar, fgetc, getw: get character 
getcwd: get pathname of current. 
getdents: read directory entries and. 
getdtablemax: get max in-use.........0 getdtablemax(2SEQ) 
getdtablesize: get descriptor table......getdtablesize(2SEQ) 
getegid: get real user, effective user, real/. getuid(2) 
getenv: return value for environment... getenv(3C) 
geteuid, getgid, getegid: get real......ssccssosesseeeeees getuid(2) 
getfrm: returns the current frame getirm(1F) 
getgeombyname: get disk/.........0000 getgeombyname(3SEQ) 
getgid, getegid: get real user, effective user,........getuid(2) 
getgrent, getgrgid, getgrnam,. etgrent(3C) 
getgrgid, getgrnam, setgrent... getgrent(3C) 
getgrnam, setgrent, endgrent, getgrent(3C) 
getgroups: get supplementary group getgroups(2) 
getitems: returns a list of the... etitems(1F) 
getlogin: get login name ..getlogin(3C) 
getmntent, hasmntopt, setmntent: get... “getmntent(3SEQ) 
getmsg: get next message off a... ... getmsg(2) 
getopt: get option letter from.. getopt(3C) 
getopt: parse command options.. getopt(1) 
getoptcvt: parse command options getopts(1) 
getopts, getoptcvt: parse command . getopts(1) 
getpagesize: get system page size.. ..getpagesize(2SEQ) 
getpass: read a password...... 
getpgrp, getppid: get process, 
getpid, getpgrp, getppid: get getpid(2) 
getppid: get process, process group... getpid(2) 
get_process_stats: get resource....get_process_stats(2SEQ) 
getpseudotty: get pseudo terminals.....getpseudotty(3SEQ) 


getpw: get name from IUD getpw(3C) 
getpwent, getpwuid, getpwnam,. -getpwent(3C) 
getpwnam, setpwent, endpwent, .getpwent(3C) 
getpwuid, getpwnam, setpwent,. .getpwent(3C) 


ets, fgets: get a string from B.....csseccsssssssssssseseseeceees gets(3S) 
gets longest line.........sccsscsesees readfile(1F) 
getscsiinfo, getscsimatch: get... getscsiinfo(3SEQ) 
getscsimatch: get scsiinfo structure.........getscsiinfo(3SEQ) 
getspent, getspnam, setspent,..... ..getspent(3X) 
getspnam, setspent, endspent.,.... ..getspent(3X) 
BOLEY. <a nsscerarescosesansscsvsnsnsesessesnsnses gettydefs(4) 


getty: set terminal type, mode: 


getty(1M) 
getty to a remote terminal....... adi 
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Permuted Index 


settings used by getty 

get real user, effective user, real/ 
microsecond clock 

pututline, setutent, endutent/ 
pututline, setutent,/ getut: 
getut: getutent, 

getut: getutent, getutid, 

/setutent, endutent, utmpname, 
getc, getchar, fgete, 

zdinfo structure 

getzdinfo, 

m_next: increment 

task: 

operating system terms and symbols 
mktime, tzset:/ ctime, localtime, 
setjmp, longjmp: non-local 

format of graphical files 

primitive string, format of 

of graphical files gps: 
plot: 

plot: 


chown, chgrp: change owner or 
newgrp: log in to a new 

run command in its own process 
initgroups: initialize 

setgroups: set 

/get real user, effective user, real 
/getppid: get process, process 
group: 

pwek, grpck: password/ 

setgrent, endgrent, fgetgrent: get 


setpgrp: set process 

create session and set process 
tegetpgrp: get foreground process 
tesetpgrp: set foreground process 
copy file and set mode, user, and 
getgroups: get supplementary 
user, real group, and effective 
setuid, setgid: set user and 

id: print user and 

groups: show 

chown: change owner and 

send a signal to a process or a 
maintain, update, and regenerate 


pwek, 
ssignal, 
stty, 


terminal fvhangup: virtually 
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gettydefs: speed and terminal.. 
getuid, geteuid, getgid, getegid: 
getusclk, usclk_init: get/init 
getut: getutent, getutid, getutline,.. 
getutent, getutid, getutline, 
getutid, getutline, pututline, setutent,/ 
getutline, pututline, setutent, endutent/... 
getutpid: access utmp file entry.........s000 .getut(3C) 
getw: get character or word from a stream.. .getc(3S) 
getzdinfo, getzdinfobyname: get. getzdinfo(3SEQ) 
getzdinfobyname: get zdinfo structure......getzdinfo(3SEQ) 


..getuid(2) 
«getusclk(8SEQ) 
-getut(3C) 
..getut(3C) 
..getut(3C) 
..getut(3C) 


global counter ts m_next(3PPS) 
Global security table a cssssasernitacisccessamavestaciactanene task(4) 
glossary: definitions of common glossary(1) 
gmtime, asctime, cftime, ascftime,.. ...ctime(3C) 


goto.. 


gps: graphical primitive string,. gps(4) 
«graphical files.......ccscsesesseeeseaees gps(4) 
graphical primitive string, format. gps(4) 
graphics interface ......sesseeessseees plot(4) 
graphics interface subroutines... plot(3X) 
greek: select terminal filter... greek(1) 
grep: search a file for a pattern. grep(1) 
group... .chown(1) 
group... newgrp(1M) 
group setpgrp(1) 
group access list... .initgroups(3SEQ) 
group access list .. ..Setgrou ps(2SEQ) 
group, and effective group IDs. » getuid(2) 
group, and parent process IDs «getpid(2) 
BTOUP file... eseeeeeeee: .-group(4) 
group file checkers... pwek(1M) 
group file entry... .-getgrent(3C) 
group: group file .-group(4) 
group ID.. setpgrp(2) 
group ID setsid(2) 
group ID. cgetpgrp(2) 
group ID tesetpgrp(2) 
group IDs ..cpset(1) 
group IDs. _getgroups(2) 
group IDs. »getuid(2) 
group IDs. i -setuid(2) 
group IDs and names... 
group memberships. 
group of a file......... 


group of processes. 
groups of programs.. 
groups: show group memberships.. 
grpck: password/group file checkers. 
gsignal: software signal........... 
gtty: set and get terminal state (defunct). 
hangup the specified controlling.............< 
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..gettydefs(4) @ 


* u3b5, vax: get processor/ 


nohup: run a command immune to 
hsearch, hcreate, hdestroy: manage 
spell, hashmake, spellin, 

crypt, setkey, encrypt: generate 
spelling errors spell, 
addmntent, endmntent, getmntent, 
search tables hsearch, 
hsearch, hcreate, 

scnohdr: section 

filehdr: file 

limits: file 

unistd: file 

ldfhread: read the file 

ldohseek: seek to the optional file 
/read an indexednamed section 
ldahread: read the archive 

helplog: monitor 

help: operating system 

helpadm: change the 


database 


file archiver hpio: 
hp: handle special functions of 
cronlog: cron 

ott: files that 

uptime: show 

Hewlett-Packard terminals 

tape file archiver 

hash search tables 

sinh, cosh, tanh: 


machid: 
consistency check 


m_get_myid: return process 
issue: issue 
fstyp: determine filesystem 


shmget: get shared memory segment i 


file and set mode, user, and group 
getgroups: get supplementary group 
process group, and parent process 
real group, and effective group 
setuid, setgid: set user and group 
id: print user and group 
/fpsetmask, fpgetsticky, fpsetsticky: 
core: format of core 

scr_dump: format of curses screen 
crash: examine system 

limits: file header for 

pwfix: remove 

m_next: 
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hangups and quits. nohup(1) 
hash search tables. hsearch(3C) 
hashcheck: find spelling errors .. +++ 8pell(1) 
hashing encryption .crypt(3C) 


hashmake, spellin, hashcheck: find. 
hasmntopt, setmntent: get file/.. 
hereate, hdestroy: manage hash... 
hdestroy: manage hash search tables. 


.getmntent(3SEQ) 
..hsearch(3C) 
..-hsearch(3C) 


header for a common object file.. ...senhdr(4) 
header for common object files... .filehdr(4) 
header for implementation-specific constants. 


. limits(4) 


header for symbolic constants 
header of a common object file... 
header of a common object file ... 
header of a common object file... 
header of a member of an archive file.. 
help actions.. 
Help Facility. 
Help Facility database 


-helpadm(1M) 


help: operating system Help Facility........ssssossceen hel p(1) 
helpadm: change the Help Facility.. -helpadm(1M) 
helplog: monitor help actions......... helplog(4) 


Hewlett-Packard 2645A terminal tape.. 
Hewlett-Packard terminals... 
history file... 
hold object architecture information 
how long system has been up.... 
hp: handle special functions of... 
hpio: Hewlett-Packard 2645A terminal .. 
hsearch, hcreate, hdestroy: manage. 
hyperbolic functions .......scssseceeeeee c 
hypot: Euclidean distance function. 
i386, ns32000, pdp11, u3b, u3b2, 
icheck: filesystem storage. 
ident: identify files.. 
identification... 
identification file 
identifier.. 


“icheck(1M) 
..ident(1) 


IEEE floating-point environment/. 


AITO POUTICS.:sscnasssaacascosnsuisnssessejesaadoenainasnsonansasedssaaiuciarsnayd core(4) 
image file .. scr_dump(4) 
images... crash(1M) 
implementation-specific constants limits(4) 


incorrectly formatted password entries... 
increment global counter. 
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dump, dumpdates: 

dump: 

restore: 

get maximum in-use descriptor table 
common/ ldtbindex: compute the 
common object/ _Idtbread: read an 
commonldshread, Idnshread: read an 
ldsseek, Idnsseek: seek to an 

receipt of an orderly release 

receive a unit data error 

specific alarms and/or the working 
specific alarms and/or the working/ 
calculate number of blocks and 
syscall: 

terminfo descriptions 

getusclk, usclk_init: get/ 

inittab: script for the 

initialization 

files directory 

list 

init, telinit: process control 

reinit: run an 

bcheckre: system 

tput: 

s_init_barrier, s_wait_barrier: 
initgroups: 

/s_lock, s_clock, s_unlock: 

setup: 


clri: clear 

fs, 

fsirand: install random 

number of free disk blocks and 
fscanf, sscanf: convert formatted 
ungetc: push character back into 
fread, fwrite: binary 

poll: STREAMS 

stdio: standard buffered 

uustat: uucp status 

install: 


fsirand: 

onthe BOM _ bomverify: perform an 
on a disk 

product: 

installboot: 

with information from/ pweonv: 
dis386: disassemble Series 386 
mailx: 

filesystem consistency check and 
console: console 

lp: Systech parallel line printer 
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-init, telinit: process control.. 


incremental dump format.....c.ccccsssressssssesssesenesseseeens 
incremental filesystem dump. 
incremental filesystem restore 


..getdtablemax(2SEQ) 
.-ldtbindex(3X) 
..ldtbread(3X) 
..ldshread(3X) 
.ldsseek(3X) 


index of a symbol table entry of a.. 
indexed symbol table entry of a. 
indexednamed section header of a 
indexednamed section of a common/ 


indication... t_revrel(3N) 
indication _revuderr(3N) 
indicator. -indicator(1F) 
indicator: display application. indicator({1F) 
indirect blocks. .nblocks(3SEQ) 
indirect system call. syscall(2) 
infocmp: compare or print out. infocmp(1M) 
init microsecond clock .getusclk(3SEQ) 
Init PPOCESS.....seerseevere -inittab(4) 


init.d: system level transition. 
initgroups: initialize group access. 


UmitialiZAation....ccscssessscseescsesersoeeccossncerseceeressvereeeeeusssee init(1M) 
Imitialization file........sssccssssessvssesseecsseeceeeeesstseneatees reinit(1F) 
initialization procedures.. -beheckre( 1M) 


initialize a terminal or query terminfo database.....tput(1) 
initialize barrier, wait at barrier......s_wait_barrier(3PPS) 
initialize group access list... -initgroups(3SEQ) 
initialize, lock, unlock locks. ;_ lock(3PPS) 
initialize system for first user. ...8etup(1) 
inittab: script for the init process.. 
INOE .eeseecssseesserecseenssenseneentonseesereoe 
inode: format of file system volume... 
inode generation numbers 
inodes... 


input..... -scan{(3S) 
input stream.. .ungete(3S) 
input/output... .fread(3S) 
input/output multiplexing .-poll(2) 
input/output package .stdio(3S) 
inquiry and job control.. «uustat(1C) 
install commands......... -instal](1M) 


install: install commands. -install(1M) 


install random inode generation numberz........fsirand(1M) 
installation consistency check based... omverify(1M) 
installboot: installs a boot program.. -installboot(1M) 
installed products file. product(4) 
installs a boot program on a disk... -installboot(1M) 
installs and updates /etc/shadow ..pweonv( 1M) 
INSETUCHIONS scsscssvesssescsnssinessinaiesvecs dis386(3SEQ) 


interactive message processing system. .-mailx(1) 
interactive repair 
interface. 


interface . 
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mtio: UNIX magnetic tape 

plot: graphics 

Generic STREAMS tty driver 
swap: swap administrative 
termio: general terminal 

tg: SCSI 1/2-inch magnetic tape 
tty: controlling terminal (gentty) 


wp: SSM parallel] line printer i 


Xylogics 472 MULITBUS magnetic tape 
timod: Transport 

STREAMS module _tirdwr: Transport 
Transport Interface read/write 

plot: graphics 
sysadm: menu 
log: 

errorlog: 
syskeymap: identify keys to 

asa: 

pathconv: search 

csh: a shell (command 

pipe: create an 

ipes: report 

stdipe: ftok: standard 

tfipe: 

ncheck: generate pathnames from 
streamio: STREAMS 


and event tracing 


abort: generate an 

semaphore set, or shared memory ID 
communication facilities status 
/isxdigit, islower, isupper, isalpha, 
isdigit, isxdigit, islower, isupper, 
Ascntrl, ispunct, isprint, isgraph, 
ttyname, 

/isupper, isalpha, isalnum, isspace, 
isalpha, isalnum, isspace, iscntrl/ 
/isspace, iscntr], ispunct, isprint, 

file manager, updates text files in 
files in ISIS file format isismgr: 
text files in ISIS file format 

isdigit, isxdigit, 

floating-point NaN (Not-A-Number) 
isnan: 

(Not-A-Number) isnan: isnand, 
/isalnum, isspace, iscntrl, ispunct, 
/isalpha, isalnum, isspace, iscntrl, 
/islower, isupper, isalpha, isalnum, 


isdigit, isxdigit, islower, 
isalnum, isspace, iscntrl/ isdigit, 


getpw: get name from 
bessel: 
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...-mMtio(7) 
.«-plot(4) 
streamtty(7) 

..8wap{ 1M) 


termio(7) 

ot g(7) 

wtty(7) 

~wp(7) 

+eXt(7) 

Interface cooperating STREAMS module timod(7) 
Interface read/write interface tirdwr(7) 
interface STREAMS module. tirdwr(7) 
interface subroutines....... -plot(3X) 
interface to do system administration. .sysadm(1) 


interface to STREAMS error logging. 
internal error log file 
internal menu system functionS...........scsseee 
interpret ASA carriage control characters 
Interpreter criteria for filename.. 
interpreter) with C-like syntax 
interprocess channel.........+00+ 
inter-process communication facilities status. 
interprocess communication package. 
interprocess communication reporter 
i-numbers........ 
jioct] commands 
ioctl: control device 
TOT fault.....ecossecssees 
ipcrm: remove a message queue,. 
ipes: report inter-process.. 
isalnum, isspace, iscntrl, ispun 
isalpha, isalnum, isspace, iscntrl/ 
isascii, tolower, toupper, toascci/...... 
isatty: find name of a terminal. 
iscntrl, ispunct, isprint, isgraph//.. 
isdigit, isxdigit, islower, isupper,. 


ncheck( 1M) 
.-Streamio(7) 
ioct](2) 
.abort(3C) 


isgraph, isascii, tolower, toupper,/ “-etype(3C) 
ISIS file format.......cssesssrssesecee -isismgr( 1M) 
ISIS file manager, updates text. -isismgr( 1M) 
isismgr: ISIS file manager, updates. -isismgr(1M) 


islower, isupper, isalpha, isalnum, isspace/. 
isnan: isnand, isnanf: test for......s.csssssosevsees 
isnand, isnanf; test for floating-point Nal/... 
isnanf: test for floating-point NaN. 
isprint, isgraph, isascii, tolower/. 
ispunct, isprint, isgraph, isascii/.. 
isspace, iscntrl, ispunct, isprint, 
issue identification file 
isupper, isalpha, isalnum, isspace,. 
isxdigit, islower, isupper, isalpha,... 
IUD... 


..ctype(3C) 
-isnan(3C) 
-isnan(3C) 
-isnan(3C) 


os “getpw(3C) 
.-bessel(3M) 


y0, yl, yn: Bessel functions 
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bessel: j0, 

bessel: j0, jl, 

uustat: uucp status inquiry and 
proto: prototype 


/erand48, lrand48, nrand48, mrand48, 
sigsetjmp, siglongjmp: non-local 
dumpconf: dump 

makekey: generate encryption 
syskeymap: identify 

apropos: locate commands by 

system command locate: use 
killall: 

m_kill_procs: 

a group of processes 


mem, 
kMBmen, 
ksh, rksh: 
standard/restricted command and/ 
integers and long integers 
and base-64 ASCII string a64l, 
filesystems 
labelit: provide 
awk: pattern scanning and processing 
be: arbitrary-precision arithmetic 
efi: Extended Fortran 
command and programming 
pattern scanning and processing 
command programming 
cftime: 
chargefee, ckpacct, dodisk, 
/setspent, endspent, fgetspent, 
/mrand48, jrand48, srand48, seed48, 
files 


ldclose, 
a member of an archive file 
for reading ldopen, 
object file 
frexp, 
routines 
common object file 
common object file symbol table/ 
number entries of a common/dlread, 
entries of a/ ldlread, Idlinit, 
manipulate line number entries of a/ 
number entries of a section of a/ 
entries of a section of a/ ldlseek, 
ofasectionofacommon/ _ldrseek, 


floating-point numbers 
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jl, jn, yO, yl, yn: Bessel functions.. 
jn, y0, y1, yn: Bessel functions. 
job control... 
job file for at... 
join: relational database operator.. 


jrand48, srand48, seed48, lcong48/... drand48(3C) 
jumps.. .-Sigsetjmp(3C) 
kernel auto-configuration device table . .dumpconf(1M) 
ROY sccssssscszesaceccsconesoansessesseoasssosestasenesnaseeus ..makekey(1) 
keys to internal menu system functions........syskeymap(4) 
keyword lookup 


keywords to identify an operating.. 
kill all active processes.. 
kill child processes......... 
kill: send a signal to a process or 
kill: terminate a process....... 
killall: kill all active processes.. 


KMEM: COTE MEMOTY uesesseseeronserseseneerneeseers 
kMWmem: MULITBUS mem0°}......-.:+2++ 
KornShell, a standard/restricted command and / paeatel ksh(1) 
ksh, rksh: KornShell, a 
13tol, ltol3: convert between 3-byte. 
164a: convert between long integer 
labelit: provide labels for 
labels for filesystems... 
language...cecsccceseseeee 


13tol(3C) 


language.. 
language... 
language. 
language specific strings 
lastlogin, monacct, nulladm, pretmp/. 
Ickpwdf, ulckpwdf: get shadow/ 
lcong48: generate uniformly/. 
ld: link editor for object...... 
1d0: STREAMS tty line discipline 
Idaclose: close a common object file. 
ldahread: read the archive header of. 
ldaopen: open a common object file . 
ldclose, ldaclose: close a common. 
ldexp, modf: manipulate parts of. 
ldfen: common object file access... 
ldfhread: read the file header of a. 
ldgetname: retrieve symbol name for. 
ldlinit, ldlitem: manipulate line... 
ldlitem: manipulate line number. 
ldlread, Idlinit, Idlitem........... 
Idlseek, Idnlseck: seek to line 
ldnlseek: seek to line number... 
ldnrseek: seek to relocation entries. 


“Idrseek(3X) 
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section header of a/ Idshread, 
section of a common object/ ldsseek, 
header of a common object file 
object file for reading 

relocation entries of a section off 
indexednamed section header of a/ 
indexednamed section of a common/ 
symbol table entry of a common/ 
table entry of a common object file 
of a common object file 

truncate a file to a specified 

init.d: system 

lexical tasks 

lex: generate programs for simple 
lsearch, 

intro: introduction to functions and 
find ordering relation for an object 
introduction to Parallel Programming 
t_sync: synchronize transport 
t_alloc: allocate a 

t_free: free a 

shell (command interpreter) with C- 
quota: display disk usage and 
ulimit: get and set user 
implementation-specific constants 
returns the number of CPUs on- 
line: read one 

puts its arguments on message 

all but one active processor off 
reads file and gets longest 

establish an out-going terminal 

set terminal type, modes, speed, and 
1d0: STREAMS tty 

set terminal type, modes, speed, and 
man: display on- 

linenum: 

Adlinit, ldlitem: manipulate 
acommon/ Idlseek, ldnlseek: seek to 
nl: 

cut: cut out selected fields of each 
Ip: Systech parallel 

wp: SSM parallel 


lsearch, lfind: 

col: filter reverse 

common object file 

readlink: read value of a symbolic 
link, unlink: 

ld: 

a.out: common assembler and 


cp, In, mv: copy, 
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Idnshread: read an indexednamed. 
Idnsseek: seek to an indexednamed 
ldohseek: seek to the optional file 
ldopen, Idaopen: open a common. 
ldrseek, Idnrseek: seek to...... 
ldshread, ]dnshread: read an 
Idsseek, ]dnsseek: seek to an...... 
ldtbindex: compute the index of a 
ldtbread: read an indexed symbol 
ldtbseek: seek to the symbol table. 
NOD Zt scscssesseiscissscssccrsesersescessess 
level transition files directory 
lex: generate programs for simp! 
Texical ta8k5 .c.cccssssscssessasessssesensees 
lfind: linear search and update. 


"Idshread(3X) 
.ldsseek(3X) 
.ldtbindex(3X) 


“truncate(2SE Q) 
.init.d(4) 


slex(1) 
“Jsearch(3C) 


libraries... -intro(3) 
library... see C and Lang Tools Binder 
Library. .intro(3PPS) 
library... _sync(3N) 
library structure. t_alloc(3N) 


library structure 
like syntax.. 
limits... 
.ulimit(2) 
»limits(4) 
cpus_online(3PPS) 
sevtess line(1) 
message(1F) 
..offline_all(3SEQ) 
waar ie 


line connection, 
line discipline. 
line discipline 
line discipline. 
line man pages.. 
line number entries in a common object file. 
line number entries of a common object/ 
line number entries of a section of. 
line numbering filter. 
line of a file. 
line printer interface... 
line printer interface 
line: read one line..... 
linear search and update 
line-feeds.. 


link and unlink files and directories 
link editor for object files 
link editor output... 
link: link to a file... 
link or move files... 
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link: 
symlink: make symbolic 
and directories 


initgroups: initialize group access 
nlist: get entries from name 
setgroups: set group access 
varargs: handle variable argument 
output of a varargs argument 

ls: 
ff: 
checklist: 
getitems: returns a 
t_listen: 

listing 

xargs: construct argument 
volcopy: make 

cp, 
ctime, 
apropos: 
operating system command 
setlocale: set programs 
end, etext, edata: last 
plock: 

m_lock, m_unlock: 

s_clock, s_unlock: initialize, 


fsck and ncheck 


ascftime, mktime, tzset/ 


lockf: record 

m_lock, m_unlock: lock, unlock 
s_unlock: initialize, lock, unlock 
diagnostic messages to form error 
errorlog: internal error 

gamma: 

newgrp: 

logging and event tracing 

logarithm, power, square root/ exp, 
about RCS files rlog: print 
/usr/adm/loginlog: 

sulog: 

logarithm, power, square/ exp, log, 
log, log10, pow, sqrt: exponential, 
strclean: STREAMS error 

strerr: STREAMS error 

log: interface to STREAMS error 
/usr/adm/loginlog: log of failed 
getlogin: get 

logname: get 

cuserid: get character 

logname: return 

passwd; change 

tfmenush: assign menu system as user 
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link to a file.. 
link, unlink: link and unlink files. 

......see C and Lang Tools Binder 
initgroups(3SEQ) 
icesapans nlist(3C) 
setgroups(2SEQ) 
....Varargs(5) 
vprint{(3S) 
.1s(1) 


list filenames and statistics for a 
list of filesystems processed by .......ssssesese0s 
list of the currently marked menu items... 
listen for a connect request.....ccececsessssssseneeesesesee t_listen(3N) 
list: produce C source see C and Lang Tools Binder 
list(s) and execute command... xargs(1) 
literal copy of filesystem... -volcopy(1M) 


-ln, mv: copy, link Or MOVE filES.....ssesesserrerserssseeesesseeeee ep(1) 
localtime, gmtime, asctime, cftime, ..ctime(3C) 
locate commands by keyword lookup.. apropos(1) 
locate: use keywords to identify an ....crcssossessereeseee locate(1) 
IOCALION....sesseeerseseeeecece setlocale(3C) 
locations in program. end(3C) 
lock process, text, or data in memory. plock(2) 


lock, unlock locks... -m_lock(3PPS) 
lock, unlock locks... 
lockf: record locking on files 
locking on files. 


locks... 


locks. s_lock(3PPS) 
log... dmesg(1M) 
log file... errorlog(4) 
log gamma function... .gamma(3M) 
log in to & NEW QrOUP....ssseserseeee .newgrp( 1M) 
log: interface to STREAMS CITor...ssssssecsessesesseeseonnesencnee log(7) 


log, log10, pow, sqrt: exponential, 
log messages and other information 
log of failed login attempts... 
log of substitute user events 
log10, pow, sqrt: exponential, 
logarithm, power, square root/... 
logger cleanup program 
logger daemon 
logging and event tracing 
login attempts... 
login name........ 
login NaMe.....seseseseees 
login name of the user, 
login name of user....... 
login password and password attributes 
login shell... 
login: sign on. 


-sulog(4) 
-exp(3M) 


..cuserid(3S) 
logname(3X) 
passwd(1) 
menush(1M) 
login(1) 
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setting up an environment at 
Ausr/adm/ 


setjmp, 

readfile, 

apropos: locate commands by keyword 
make a database for fast password 
relation for an object library 

the LP print service 

cance]: send/cancel requests to the 
lpadmin: configure the 

administer filters used with the 
administer forms used with the 
information about the status of the 
Apshut, lpmove: start/stop the 
enable, disable: enable/disable 
accept, reject: allow or prevent 
interface 

service 

with the LP print service 

the LP print service 

processing module 

service and move/ _Ipsched, Ipshut, 
the LP print service and move/ 

print service and move/ Ipsched, 
status of the LP print service 
supported by the menu system 
priorities 

srand48, seed48/ drand48, erand48, 


update 


stat, 

integers and long integers 13tol, 
u3b2, u3b5, vax: get processor type/ 
show the configuration of the 

sysi86: 

values: 

sgetl: access long integer data ina 
m4: 

mtio: UNIX 

tg: SCSI 1/2-inch 

xt: Xylogics 472 MULITBUS 

mt: 

rmail: send mail to users or read 
read mail 

mail, rmail: send 

enhancement request 

processing system 

groups of programs make: 
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logname: get login name...........00+ 

logname: return login name of user 
longjmp: non-local Zoto....s..esesssseere a 
longline: reads file and gets longest line “readfile(1F) 


..apropos(1) 


lorder: find orderin; 
Ip, cancel: send/cancel requests to 
LP print service. 
LP print service 


LP print service... 
LP print service and move requests. 
LP printers... 
LP requests.... 


“Ipsched(1M) 
..enable(1) 
accept(1M) 


Ip: Systech parallel line printer.....cccssssssscssesesceenesesseneene 1p(7) 
lpadmin: configure the LP print.. padmin(1M) 
Ipfilter: administer filters used.. ..lpfilter(1M) 
lpforms: administer forms used with... lpforms(1M) 
lpmod: parallel printer canonical. .lpmod(7) 
lpmove: start/stop the LP print. Ipsched(1M) 
Ipsched, Ipshut, Ipmove: start/sto: lpsched(1M) 
Ipshut, Ipmove: start/stop the LP... lpsched(1M) 
Ipstat: print information about the... ..lpstat(1) 
Iptypes: table of printer types ».lptypes(4) 
Ipusers: set printing queue... .lpusers( 1M) 


lrand48, nrand48, mrand48, jrand48,.. ...drand48(3C) 
ls: list contents of directory........ 
Isearch, Ifind: linear search and. 
lseek: move read/write file pointer .. 
Istat, fstat: get file status 
l1tol3: convert between 3-byte. 
M4: MACTO PLOCESSOF .....seeeeee+e 
machid: i386, ns32000, pdp11, u3b,. 
MACHING ...eeccessssessssessreeeeees 
machine specific functions.. 
machine-dependent values. 
machine-independent fashion 


..lsearch(3C) 
-lseek(2) 


soe 4(1) 
-machid(1) 
s yet on 


vee (1) 


MACTO PYOCCSSOF..esssseeeeee 
magnetic tape interface --mtio(7) 
magnetic tape interface. tg(7) 


magnetic tape interface. 
magnetic tape manipulating program. 
mail. 
mail, rmail: send mail to users or. 
mail to users or read mail.......... 
mailbug: submit a bug report or. 
mailx: interactive message. 
maintain, update, and regenerate.. 
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programs intro: introduction to 
/ttyname_to_dev: convert between 
regenerate groups of programs 

man page databases 


databases makealiases, 
/free, realloc, calloc, mallopt, 
memory allocator 

mallopt, mallinfo: fast main memory/ 
malloc, free, realloc, calloc, 


makealiases, makewhatis: generate 
man: display on-line 

tsearch, tfind, tdelete, twalk: 
hsearch, hcreate, hdestroy: 
t_optmgmt: 

passmgmt: password files 
sigignore, sigpause: signal 
format disks or perform other defect 
file format isismgr: ISIS file 
mt: magnetic tape 

parameters of virtual-to-physical 
m_single, m_multi: 

umask: set file-creation mode 
umask: set and get file creation 
regex: 

regular expression compile and 
math: 


endpoint 


comment section 


read the archive header of a 

groups: show group 

memset: memory operationsnemory: 
memory operatiommemory: memcepy, 
operationmmory: memccpy, memchr, 
memory: memccpy, memchr, mememp, 
kMBmem, kMWmem: MULITBUS 
mem, kmem: core 

lock process, text, or data in 

create security table in shared 
malloc, free, realloc, calloc: main 
calloc, mallopt, mallinfo: fast main 
shmalloc, shrealloc, shfree: shared 
valloc: aligned 

shmctl: shared 

consmem, sm, ss: console 

dump: standalone 

spawn new process in a virtual 
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- Management... 


maintenance commands and application............. intro(1) 
major/minor numbers/tty nameS......... dev_to_ttyname(3C) 
make: maintain, update, and. make(1) 
makealiases, makewhatis: generate .. eo oe 1M) 
makedev: make system special files 
makekey: generate encryption key. 
makewhatis: generate man page... 
mallinfo: fast main memory allocator. 
malloc, free, realloc, calloc: main 
malloc, free, realloc, calloc, 
mallopt, mallinfo: fast main memory/. 


..malloc(38X) 
.-malloc(3C) 
.--malloc(3X) 


man: display on-line MAN PAageS.....sescsssecorcerersserereats man(1) 
man page databasces.... makealiases(1M) 
TED PAQECS...cececsesessecesssrseeessesersesansnerenerecensearnecessesessnsoes man(1) 
manage binary search trees. ..tsearch(3C) 
manage hash search tables... -hsearch(3C) 


manage options for a transport. ..t_optmgmt(3N) 


management... ....Sigset(2) 
management functions..... format(1M) 
manager, updates text files in ISIS. -isismgr(1M) 
manipulating Program......ssssssscsssesressssseserosessssrrerenceses mt(1) 
mapping devices .. pmap(1M) 
mark single-process code section. -m_single(3PPS) 
mask... ..umask(1) 
mask... ..umask(2) 
match patterns against a string. .regex(1F) 
MAtCh routine ....serceeesrereeeees .regexp(5) 
math functions and constants .math(5) 
math: math functions and constants .math(5) 
matherr: error-handling function 


mbad: MULITBUS adapter...... mbad(7) 
mcs: manipulate the object file... ..mcs(1) 
MEM, KMEM: COTE MEMOTY.....-ecesecssecesrsererorceceveresseees mem(7) 
member of an archive file Idahread(3X) 
MOMbETShI PSs sicicscicrsendscserascerarscecieseivecsisavavsavevescrsensd groups(1) 


memory(3C) 


memccpy, memchr, memcmp, memepy,.. 
memory(3C) 


memchr, memcmp, memepy, memset:. 
memcmp, memcpy, memset: memory.. 
memcpy, memset: memory operations 


.tasktbl(1M) 
«malloc(3C) 
.-malloc(3X) 


memory allocator... .shmalloc(3PPS) 
memory allocator.......secssee .-valloc(3SEQ) 
MEMOTY Contro] Operations. .....scsssesereroeesseerseeneersen shmctl(2) 
MEMOTY FiVETS.....esece0e 

MeMOTry duMP......00000 


memory efficient way 
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queue, semaphore set, or shared 
memcpy, memset: memory operations 
memchr, mememp, memcpy, memset: 
shmop, shmat, shmdt: shared 

vmtune: tune system-wide virtual- 
shmget: get shared 

vm_ct]: examine and change virtual 
memccpy, memchr, memecmp, memepy, 
addcmdopt: add a command option to a 
add a form/SELECT window option to a 
addmenuopt: add a menu option to a 
sysadm: 

a list of the currently marked 


menumsg: route user message to 
rmvopt: remove a 

addmenuopt: add a 

menu: 

of printer types supported by the 
tfmenush: assign 

syskeymap: identify keys to internal 
message queue 

for generating/modifying ASSIST 
merge: three-way file 

sort: sort and/or 

acctmerg: 

resmerge: 


subsequent lines of one file _ paste: 


t_error: produce error 

tfnotify: send completion 

msgctl: 

message: puts its arguments on 
getmsg: get next 

putmeg: send a 

msgop: 

mailx: interactive 

message line 

menumsg;: route user message to menu 
msgget: get 
iperm: remove a 
errormsg: error 
menumsg: route user 

motd: 

mesg: permit or deny 

sys_errlist, sys_nerr: system error 
strace: print STREAMS trace 

rlog: print log 

dmesg: collect system diagnostic 
parallel 

identification 


shared memory ID 
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memory ID. 
memory: memccpy, memchr, memcmp, 
memory operations... 
memory operations. 
memory parameters. 
memory segment identifier 
memory tuning parameters... 
memset: memory operations. 


..memory(3C) 
.-memory(3C) 
..8hmop(2) 


addmenuopt(1M) 
menu interface to do system administration.......sysadm(1) 
menu items -getitems(1F) 
menu: menu processor .. .«.menu(1M) 
menu message queue.... .-menumsg( 1M) 
MENU OPtiON........seeeeee ...rmvopt(1M) 
menu option to a menu. addmenuopt(1M) 
MENU PFOCESBOL......e00 .menu(1M) 
MENU SYStEM......scccecsseeees aeaenaote .-lptypes(4) 
menu system as user login shel ..tfmenush(1M) 


menu system functions... syskeymap(4) 
menumsg: route user message to menuv........ menumsg( 1M) 
menus or command forms 


Cee astgen(1) 
merge.... aes -merge(1) 
merge files.. 
merge or add total accounting files 
merge RCS revisions 
merge same lines of several files o or. 
merge: three-way file merge......... 
mesg: permit or deny messages. 
message... 


message... ..tfnotify(1M) 
message control operations. .-.-msgct](2) 
message line.........++ -message(1F) 
message off a stream.. .-getmsg(2) 
message on a stream. ..putmsg(2) 


message operations... 
message processing system. 
message: puts its arguments on 
message queue.. 
message queue... 
message queue, semaphore set, or. 
message text file. 
message to menu message queue. 
message-of-the-day file.. 
MCSSAZEB....scesseeseseesenes 

messages... 
messages.. 
messages and other information about RCS files.......rlog(1) 
messages to form error log ...dmesg(1M) 
m_fork: execute a subprogram in.. -m_fork(3PPS) 
m_get_myid: return process. .-m_get_myid(3PPS) 


msgop(2) 
«mailx(1) 
-message(1F) 


“errormsg(4) 
— 1M) 
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number of child processes 

getusclk, usclk_init: get/init 

usclk: 32-bit 

aging, PFF, swapping, or processor 
clone: open any 

/convert between major/ 

/acctwtmp: overview of accounting and 
intro: introduction to 


special or ordinary file 
password lookup 


/gmtime, asctime, cftime, ascftime, 


processs address space 


section m_single, 


configuration file 

chmod: change 

umask: set file-creation 

chmod: change 

cpset: copy file and set 

getty: set terminal type, 
uugetty: set terminal type, 
frexp, ldexp, 

utime: set file access and 
touch: update access and 
astgen: program for generating/ 
printer canonical processing 
SSM: System Services 

Interface cooperating STREAMS 
read/write interface STREAMS 
mod_config: format of a 
/ckpacct, dodisk, lastlogin, 
helplog: 


monitor: 
atime 


mount: 
mount, umount: 


setmont: establish 
filesystems 
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m_get_numprocs; return......see m_get_numprocs(3PPS) 
microsecond clock .getusclk(3SEQ) 
...usclk(7) 


migration disabled..... 

minor device on a STREAMS drive: 
minor numbers and tty names. 
miscellaneous accounting commands. 


mkdir: make a directory... 
mkdir: make directories... 
mokfifo: make a FIFO special file. 
mkfs: construct a filesystem... 
m_kill_procs: kill child processes. 
mknod: build special file 
mknod: make a directory, or a. 
mkpwdbm: make a database for fast. 
mktemp: make a unique filename.... 
anktime, tzset: convert date and time/ 
mkvtoc: populate VTOC on disks... 
m_lock, m_unlock: lock, unlock locks... 
mmap: map an open file into the... 
m_multi: mark single-process cod 
m_next: increment global counter.... 
mnttab: mounted filesystem table 
mod_config: format of a module... 


mk fs(1M) 
-ro_kill_procs(3PPS) 
-mknod(1M) 
.... mknod(2) 
..mkpwdbm(1M) 
mktemp(3C) 
..ctime(3C) 


-mmap(2SEQ) 
m_single(3PPS) 
m_next(3PPS) 
.»mnttab(4) 
mod_config(4) 
«chmod(1) 
.umask(1) 
.chmod(2) 


mode mask.. 
mode of file... 

mode, user, and group IDs 
modes, speed, and line disciplin 
modes, speed, and line discipline.. 
modf: manipulate parts of floating-point/. 
modification times 
modification times of a file 
modifying ASSIST menus or command/ 
module. 
Module. 
module.. 
module... 
module configuration file 
monacct, nulladm, pretmp, prdaily,/ 
monitor help actions... 
monitor: monitor system activity .. 
monitor: prepare execution profile 
monitor system activity.........0 
more: view a file one full screen at. 
motd: message-of-the-day file.. 
mount a filesystem .....sessssc-s000 
mount and unmount filesystems 


“astgen(1) 
ae 


mod. |_config(4) 
.acctsh(1M) 
.-helplog(4) 
..monitor{ 1M) 
monitor(3C) 
--monitor(1M) 


..motd(4) 
-mount(2) 
-mount(1M) 


mount: mount a filesystem -mount(2) 
Mount table.......sessececeereeee setmnt(1M) 
mount, umount: mount and unmoun’ ...mount(1M) 
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mountall, umountall: 

multiple filesystems 

munttab: 

mvdir: 

cp, In, mv: copy, link or 

lseek: 

start/stop the LP print service and 
and resume child process execution 


ptrace, 

drand48, erand48, lrand48, nrand48, 
child process/ m_park_procs, 
processes 


single-process code section 


program 
st: Systech 


mbad: 

xt: Xylogics 472 

kMBmem, kMWmem: 

mountall, umountall: mount, unmount 
poll: STREAMS input/output 

Systech MTI-800/1600/1650 terminal 
xs: Xylogics 781 terminal 

tmp_ctl: 

re2: run commands performed for 
m_lock, 

address space 

cp, In, 


devnm: device 

getenv: return value for environment 
getgeombyname: get disk geometry by 
getlogin: get login 

logname: get login 

pwd: working directory 
tmpnam, tempnam: create a 
ldgetname: retrieve symbol 
getpw: get 

nlist: get entries from 
rename: change the 
ttyname, isatty: find 

uname: get 

uname: print 

tty: get the 

cuserid: get character login 
logname: return login 
Adnshread: read an indexed 
Adnsseek: seek to an indexed 


table/ 
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mount, unmount multiple filesystems............ mountall(1M) 
mountall, umountall: mount, unmount. mountall(1M) 
mounted filesystem table........ssssssscsssessssessssssssecees mnttab(4) 
move a directory.. «-mvdir(1M) 
MUUOVG WERNGES 5 csadasscausos ctocsesstarssses toonievdasteakiqeesthesnlesctstet bees ep(1) 
move read/write file pointer lseek(2) 
MOVE TEQUESES....sscssrseeeeeees -lpsched(1M) 
m_park_procs, m_rele_procs: susp/....m_park_procs(3PPS) 
mptrace: process trace facility ptrace(2) 
mrand48, jrand48, srand48, seed48,/ ..drand48(3C) 


m_rele_procs: suspend and resume....m_park_procs(3PPS) 
m_set_procs: set number of child...........m_set_procs(3PPS) 
msgctl: message control operation: ....msgctl(2) 
msgget: get message queue.. 
msgop: message operations .. 
m_single, m_multi: mark. 
m_synce: check in at barrier.. 
mt: magnetic tape manipulating. 
MTI-800/1600/1650 terminal multiplexor driver 
mtio: UNIX magnetic tape interface . 
MULITBUS adapter.. 
MULITBUS magnetic tape interface .. 
MULITBUS memory .... 
multiple filesystems... 
multiplexing 
multiplexor driver 
multiplexor driver... 
multi-processor control. 
multi-user environment.... 
m_unilock: lock, unlock locks.......... 
munmap: unmap part of the processs.. 
mv: copy, link or move files... 
mvdir: move a directory 
name..... 


devnm( 1M) 


NON iascscecsvstsadseccsszecssassaisnsesssorsninicscssnastassacariaasiend’ getenv(3C) 
name getgeombyname(3SEQ) 
name. »getlogin(3C) 


name.. 
name.... 
name for a temporary file. 
name for common object file symbol. 
name from IUD. 
name list....... 
name of a file.. 
name of a terminal... 
name of current operating system. 
name of current system.. 


-logname(1) 


..tmpnam(3S) 
..ldgetname(3X) 
getpw(3C) 
-nlist(3C) 
rename(2) 
..ttyname(3C) 
...uname(2) 


name Of the terminal.......sssccssosssscessneserensnsasasscenestseeseee tty(1) 
name of the user. ....cuserid(3S) 
name of user....... ..logname(3X) 
named section header of a common object/.....ldshread(3X) 
named section of a common object file... ...ldsseek(3X) 

37 


Permuted Index 


between major/minor numbers and tty 
id: print user and group IDs and 

term: conventional 

isnanf: test for floating-point 
processing language 

and indirect blocks 

of filesystems processed by fsck and 
i-numbers 

uucp: 

file 


news: print 


getmsg: get 


object file 

command with priority aging, PFF/ 
hangups and quits 

setjmp, longjmp: 

sigsetjmp, siglongjmp: 

with priority aging, PFF/ noage, 
priority aging, PFF/ noage, nopff, 
test for floating-point NaN 

seed48/ drand48, erand48, lrand48, 
deroff: remove 
machid: i386, 
null: the 


vax: get processor/ 


/ckpacct, dodisk, lastlogin, monacct, 
obtain the prime factors of a 
getfrm: returns the current frame 
test for floating-point NaN (Not-A- 
convert string to double-precision 
linenum: line 

Adlinit, ldlitem: manipulate line 
ldlseek, ldnlseck: seek to line 

rand, srand: simple random- 
nblocks: calculate 
m_get_numprocs: return 
m_set_procs: set 

cpus_online: returns the 

df: report 

fevt, gevt: convert floating-point 

nl: line 

uniformly distributed pseudorandom 
manipulate parts of floating-point 
install random inode generation 

to system calls and error 
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names. 
names... 
names for terminals... 


-isnan(3C) 


nawk: pattern scanning and .-.-nawk(1) 
nblocks: calculate number of blocks nblocks(3SEQ) 
MONE ccna .checklist(4) 
nceheck: generate pathnames from .ncheck(1M) 


networking support files 
newform: change the format of a text. 
newfs; construct a new file system 
newgrp: log in to a new group 
news items..... 
news: print news items.. 
next message off a stream. 
nice: change priority of a process.. 
nice: run a command at low priority 
nl: line numbering filter... 
nlist: get entries from name list 
nm: print name list of.......00..+ see C and Lang Tools Binder 
noage, nopff, noswap, onproc: run a. 
nohup: run a command immune to 
non-local goto 
non-local jumps. 
nopff, noswap, onproc: run a command... 
noswap, onproc: run a command with... 
(Not-A-Number), 
nrand48, mrand48, jrand48, srand48, 
nroff, tbl, and eqn constructs......... 
ns32000, pdp11, u3b, u3b2, u3b5,. 
DUI] file... eseseeeeeee 
null; the null file ... 
nulladm, pretmp, prdaily, prtacct/.. 


-news(1) 
.news(1) 


..null(7) 
.null(7) 
.-acctsh(1M) 


number... .-factor(1) 
number. ..getirm(1F) 
Number). ...isnan(3C) 
UMD ER i iscscsscasscasiacatsscircedssisitisveneasstvanas used »»-Strtod(3C) 
number entries in a common object file.. . linenum(4) 
number entries of a common object/.. -ldlread(3X) 
number entries of a section of a/ .Idlseck(3X) 
TUMbE” BENeTAtOr e.-cscsssoseresereccsenscssseserarsevecesssscacasene rand(3C) 
number of blocks and indirect blocks .nblocks(3SEQ) 


...m_get_numprocs(3PPS) 
.m_set_procs(3PPS) 
.-cpus_online(3PPS) 


number of child processes 
number of child processes. 
number of CPUs on-line... 
number of free disk blocks and inodes.. 
number to string... 
numbering filter 
numbers... 


..drand48(3C) 


numbers... .frexp(3C) 
numbers.. fsirand(1M) 
numbers.. intro(2) 
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ncheck: generate pathnames from i- 
‘convert between major/minor 

cprs: compress an 

strstr: find first 

od: 


offline: bring processors online and 
online, 

processor off line 

online, offline: bring processors 
online and offline 
noage, nopff, noswap, 
Idopen, ldaopen: 
fopen, freopen, fdopen: 
clone: 

dup: duplicate an 
dup2: duplicate an 
mmap: map an 

open: 


aging, PFF/ 


rewinddir, closedir/ directory: 

a standalone program or bring up the 
run commands performed to stop the 
savecore: save a core dump of the 
uname: get name of current 

locate: use keywords to identify an 
assist: assistance using 

starter: information about the 

help: 

glossary: definitions of common 

join: relational database 

curses: terminal screen handling and 
rmvopt: remove a menu 

getopt: get 

addcmdopt: add a command 
addformopt: add a form/SELECT window 
addmenuopt: add a menu 
ldohseek: seek to the 
fentl: file control 

getopt: parse command 
getopts, getoptcvt: parse command 
stty: set the 

t_optmgmt: manage 

make a directory, or a special or 
architecture information 

common assembler and link editor 
echo: put string on virtual 

fread, fwrite: binary input/ 

fprintf, sprintf: print formatted 
poll: STREAMS input/ 

Wfprintf, vsprintf: print formatted 
stdio: standard buffered input/ 


object file 
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ncheck(1M) 


numbers and tty names... .dev_to_ttyname(3C) 
object file. see C and Lang Tools Binder 
occurrence of character. ..8trstr(3C) 
octal dump........ ..0d(1) 
od: octal dump.. ..00(1) 
offline. online(1M) 
offline: bring processors online and offline .. online(1M) 
offline_all: take all but one active. offline_all(3SEQ) 
online and offline... online(1M) 
online, offline: bring processors. ....online(1M) 
onproc: run a command with priority -noage(1M) 
open a common object file for reading. Idopen(3X) 
OPEN B StTEAM....cscceeseeeseee fopen(3S) 
open any minor device on a STREAMS driver... clone(7) 
open file descriptor... dup(2) 
open file descriptor... dup2(2) 
open file into the processs a 88 Space... 


open for reading or writing.......... 
open: open for reading or writing 
opendir, readdir, telldir, seekdir,.. 
operating system... 
operating system... 
operating system.. 
operating system... 
operating system command... 
operating system commands 
operating system for beginning users, 
operating system Help Facility....... 
operating system terms and symbols.. 


.curses(3X) 


OPLION ..cscrossseeseneecaneees ..rmvopt(1M) 


option letter from argument VeCtOF.......cssesseseee getopt(3C) 
option to a menu... addcmdopt(1M) 
option to a menu ..addformopt(1M) 
option to a menu... addmenuopt(1M) 
optional file header of a common Idohseek(3X) 
options... ...fentl(5) 


option: 
options... 
options for a terminal... 
options for a transport endpoint. 
ordinary file 
ott: files that hold object. 


getopt(1) 
..getopts(1) 


output... 
output multiplexing. 
output of a varargs argument list... 
output package 
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setpgrp: run command in its 
chown: change 

chown, chgrp: change 

expand files 

makewhatis: generate man 
getpagesize: get system 

4014: 

m_fork: execute a subprogram in 
lp: Systech 

wp: SSM 

lpmod: 

intro: introduction to 

and change virtual memory tuning 
tune system-wide virtual-memory 
pmap: display or alter 

get process, process group, and 
getopt: 

getopts, getoptcvt: 

cmpt: compatibility 

vtoc: VTOC 

frexp, ldexp, modf: manipulate 


with information from /ete/ 
password attributes 


getpass: read a 

crypt: 

passwd; change login 

passwd; change login password and 
pwdhd: daemon to oversee 

pwfix: remove incorrectly formatted 
passwd: 

shadow: restricted 

setpwent, endpwent, fgetpwent: get 
Ickpwdf, ulckpwdf: get shadow 
putpwent: write 

putspent: write shadow 

converts from a two to a one 
passmgmt: 

mkpwdbm: make a database for fast 
pwek, grpck: 

files or subsequent lines of one/ 

bp: binary 


configurable pathname variables 
criteria for filename 

getewd: get 

fpathconf: get configurable 
dirname: deliver portions of 
ncheck: generate 

sweepon, sweepoff: enable/disable 
grep: search a file fora 
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setpgrp(1) 
shown(2) 


own process group......... 
owner and group of a file... 
OWNEY OF QTOUP....eseeseeee 
pack, peat, unpack: compress and....esesescscesssssseenreees pack(1) 
page databases. .-makealiases(1M) 


page size... .. getpagesize(2SEQ) 
paginator for the Tekt: Mall secasscsasssss 4014(1) 
parallel -m_fork(3PPS) 


parallel line printer interface 1p(7) 
parallel line printer interface... .wp(7) 
parallel printer canonical processing module.. pmod(7) 
Parallel Programming Library ........ssssesesssseeseee intro(3PPS) 
parameters.... 
parameters... 


parameters of virtual-to-physical mapping/. 
parent process IDs... 
parse command options. 
_parse command options 
partitioning driver 
partitioning driver. 
parts of floating-point numbers. 
passmgmt: password files management. 
passwd 
passwd: change login password and. 
passwd: password file 
password... 
password and file encryption functions... 
password and password attributes... 
PASSWOTE AttTIDULES....ccsscesenceearecoraee 
password database creation... 
password entries. 
password file. 


.getopts(1) 
....cmpt(7) 


.getpass(3C) 
..crypt(3X) 
passwd(1) 
passwd(1) 
..pwdhd(1M) 
pwfix(1M) 
passwd(4) 


password file... ..Shadow(4) 
password file entry... .getpwent(3C) 
password file entry.. ..getspent(3X) 
password file entry... 


.putpwent(3C) 
password file entry....... ia 
password file scheme.. 
password files management 
password lookup 
password/group file checkers... 
paste: merge same lines of several 
patcherarancinvenniasannts 
pathalias: alias file for FACE 
pathconf, fpathconf: get........ 
pathconv: search Interpreter... 
pathname of current working directory. 


.. passmgmt(1M) 
..mkpwdbm(1M) 
pwck(1M) 
.-.paste(1) 
.-bp(1M) 
-alias(4) 
-pathcon{(2) 
.pathconv(1F) 
.getewd(3C) 


pathname variables. -pathcon{{2) 
pathnames. ..basename(1) 
pathnames from i-numbers. ....ncheck(1M) 


patrol seeks on DCC disks. -sweepon(1M) 
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awk: 

nawk: 

egrep: search a file fora 
regex: match 


pack, 
popen, 


machid: i386, ns32000, 

sigpending: examine 

check the uucp directories and 

acct: 

acctcms: command summary from 
sys_nerr: system error messages 
run a command with priority aging, 


virtual address space = pmap: map 
or alter parameters of virtual-to- 


sp: STREAMS 

tee: 

popen, pclose: initiate 
in memory 


virtual-to-physical mapping devices 
processs virtual address space 
/fpsetsticky: IEEE floating- 

isnand, isnanf: test for floating- 
ecvt, fevt, gcvt: convert floating- 
modf: manipulate parts of floating- 
lseek: move read/write file 

rewind, ftell: reposition a file 
multiplexing 

@ process 

banner: make 

power, square root/_ exp, log, log10, 
pow, sqrt: exponential, logarithm, 


/dodisk, lastlogin, monacct, nulladm, 
Aastlogin, monacct, nulladm, pretmp, 
be: arbitrary- 

atof: convert string to double- 
environ, 

monitor: 

cpp: the C language 

factor: obtain the 

gps: graphical 

types: 

prs: 

date: 

cal: 
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pattern scanning and processing language... 
pattern scanning and processing language 
pattern using full regular/, 
patterns against a string... 
pause: suspend process until signa 
peat, unpack: compress and expand files. 


pclose: initiate pipe to/from a process........ssessse 

pdbx, dbx: parallel/.......... 

pdp11, u3b, u3b2, u3b5, vax: get processor/......... 

pending signals. sigpending(2) 


permissions file.. 
per-process accounting file format. 
per-process accounting records... 
perror, errno, sys_erriist,..... 
PFF, swapping, or processor/ 
pg: file perusal filter for CRTs.. 
physical addresses into processs 


-uucheck(1M) 


physical mapping devices............ 

pipe: create an interprocess channel. pipe(2) 
pipe device.. .8p(7) 
pipe fitting... -tee(1) 
pipe to/from a process. popen(3S) 


plock: lock process, text, or data. 
plot: graphics interface......sccecesesssaee 
plot: graphics interface subroutines.. 
pmap: display or alter parameters of. 


pmap: map physical addresses int ....ssssssssesorseeeee pmap(7) 
point environment control.... fpgetround(3C) 
point NaN (Not-A-Number).. 


isnan(3C) 
point number to string... é 
point numbers 


POINter......es00 

pointer in a stream... 

poll: STREAMS input/output 

popen, pclose: initiate pipe to/from popen(3S) 
POSOTS iasscesssscsicsoscssnssaasussceasssoaseseias banner(1) 


pow, sqrt: exponential, logarithm, 
power, square root functions. 


PPUTPHINt Fes. ccssscscerescsssscossieiarsostenesnssasassecsssocsstssassensaarass pr(1) 
pretmp, prdaily, prtacct, shutacct,/ .acctsh(1M) 
prdaily, prtacct, shutacct, startup/, .acctsh(1M) 


precision arithmetic language.. 
precision number. 
-pref, .variables: FACE files... 
prepare execution profile. 
preprocessor 
prime factors of a number.... 
primitive string, format of graphical file: 
primitive system data types. 
print an SCCS file.........sssess00 
print and set the date. 
print calendar 


..see C and Lang Tools Binder 
..factor(1) 
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sum: 

sact: 

cat: concatenate and 

pr: 

printf, fprintf, sprintf: 
vprintf, vfprintf, vsprintf: 


of the LP print service Ipstat: 
information about RCS files rlog: 
object file nm: 
uname: 

news: 


infocmp: compare or 

acctcom: search and 

of object files size: 
send/cancel requests to the LP 
lpadmin: configure the LP 
administer filters used with the LP 
administer forms used with the LP 
about the status of the LP 

Apshut, lpmove: start/stop the LP 
strace: 


lpmod: parallel 

Ip: Systech parallel line 

wp: SSM parallel line 

Iptypes: table of 

enable, disable: enable/disable LP 
formatted output 

Ipusers: set 

Ipusers: set printing queue 

nice: run a command at low 
/noswap, onproc: run a command with 
nice: change 

brk, sbrk: change 

process attributes 

codestroy: communicate to a 

exit, exit: terminate 

fork: create a new 

inittab: script for the init 

kill: terminate a 

nice: change priority of a 

pclose: initiate pipe to/from a 
wait: await completion of 

acct: enable or disable 

acctprel, acctpre2: 

acct: per- 

acctcom: search and print 
acctcms: command summary from per- 
alarm: set a 

times: get 
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: print checksum and block count of a file... 


print current SCCS file editing activity 


print formatted output, 
print formatted output of a varargs/. 
print information about the status.. 
print log messages and other. 
print name list of... 
print name of current system 
PYrint NewS iteMS ......ceseeeeeee 
print out terminfo descriptions. 
print process accounting files... 
PFint SeCtioN SiZEB .......esscseeseeee 
print service.. 
print servic 
print service... 
print service... 
print service .. 
print service and move requests... 
print STREAMS trace messages 
print the VTOC of a block device.. 
print the VTOC of a standalone disk device 
print user and group IDs and names.. 
printer canonical processing module. 
printer interface.. 
printer interface . 
printer types supported by the menu system. 


.see C and Lang Tools "Binder 


-uname(1) 


.lpadmin(1M) 
Ipfilter(1M) 
..|pforms(1M) 
coal Ipstat(1) 
psched(1M) 
.strace(1M) 


..1p(7) 


Iptypes(4) 


printf, fprintf, sprintf: print. 
printing queue priorities... 


priorities. Ipusers(1M) 
PYIOTILY......ccsssseoscocesenseressorssscesnsssssseseensnenessonsresceeerscsssors nice(1) 
priority aging, PFF, swapping, or/ -noage(1M) 
PTIOTIty Of @ PFOCESS......csesssseseereceesersensonssssnsosanserseearense nice(2) 


.-brk(3PPS) 
proc_ctl(2SEQ) 
..coproc( 1F) 
».exit(2) 
fork(2) 
inittab(4) 
.-Kill(1) 
-nice(2) 
popen(3S) 
wait(1) 
-acct(2) 
..acctpre(1M) 
acct(4) 
..acctcom(1) 


private data segment size 
proc_ctl: contro] over various.. 
process.. 
process... 
process .. 
process.. 
process... 
process .. 
process... 
process.. 
process accounting... 
process accounting... 
process accounting file format. 
process accounting files... q 
process accounting records. .acctems(1M) 
process alarm clock. ...alarm(2) 
process and child process times......sssssorssoserernererenene times(2) 
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EE 


proc_ctl: control over various 
m_single, m_multi: mark single- 
ipes: report inter- 

init, telinit: 

timex: time a command; report 
suspend and resume child 
setpgrp: run command in its own 
/getpgrp, getppid: get process, 
setpgrp: set 

setsid: create session and set 
tegetpgrp: get foreground 
tesetpgrp: set foreground 
m_get_myid: return 

process, process group, and parent 
vfork: spawn new 

kill: send a signal to a 

getpid, getpgrp, getppid: get 

ps: report 

plock: lock 

times: get process and child 
tmp_affinity: bind a 

wait, waitpid: wait for a child 
ptrace, mptrace: 

pause: suspend 

vsig: synchronize a co- 

checklist: list of filesystems 

a signal to a process or a group of 
killall: kill all active 

return number of child 
m_kill_procs: kill child 
m_set_procs: set number of child 
fuser: identify 

m4: macro 

menu: menu 

tmp_affinity: bind a process to a 
tmp_ctl: multi- 

priority aging, PFF, swapping, or 
offline_all: take all but one active 
pdp11, u3b, u3b2, u3b5, vax: get 
online, offline: bring 

mmap: map an open file into the 
munmap: unmap part of the 
pmap: map physical addresses into 


monitor: prepare execution 
profil: execution time 

prof: display 

at login time 

prof: 
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process attributes. 
process code section... 
process communication facilities status. 
process control initialization... 
process data and system activity. 
PTOCESS EXECULION..........sseeserereerer 
process group. 
process group, and parent process IDs 
process group ID... 


..proc_ctl(2SEQ) 
-0a_single(3PPS) 


PKOCESE OUP ID se ssscssssscesscssdezcccecccssisesissscsnsescseesvenseces setsid(2) 
process group ID. tegetpgrp(2) 
process group ID... tesetpgrp(2) 
process identification 


process IDs 
process in a virtual memory efficient way 
process or a group Of processeS......scssseseeees 
process, process group, and parent/. 
PTOCESS StALUB.......ccececerssssseesacere 
process, text, or data in memory. 


.--ps(1) 
“plock(2) 


PYOCESS CHM sassssccassscatssececiessctesrsceseesoosanaseceies maaeaaascand times(2) 
process to a processor. .tmp_affinity(2SEQ) 
Process to Stop OF tErMINALE.........sccssersscscrcssecscesrsceserse wait(2) 


process trace facility.. 
process until signal... 
process with the controlling FMLI object 
processed by fsck and ncheck........ vendsazed 
processes 
processes. 
processes 
processes, 
processes... 
processes using a file or file structure.. 
PIOCCSSOF o.ssesssssesseceroes 

processor... 


-m_get_numprocs(3PPS) 
-m_kill_procs(3PPS) 
..M_set_procs(3PPS) 
.fuser(1M) 


processor... .tmp_affinity(2SEQ) 
processor control. .-tmp_ctl(2SEQ) 
processor migration disabled..........sssssssscsssssserenee noage(1M) 
processor off line..........s0 offline_all(3SEQ) 
processor type truth value ...-machid(1) 
processors online and offline.. .«.online(1M) 
processs address space.. -mmap(2SEQ) 
processs address space... iliac | 


processs virtual address space, 
product: installed products file. 
prof: display profile data... 
prof: profile within a function.. 
profil: execution time profile 
profile... 
profile.. 
profile data 
profile: setting up an environment 
profile within a function.. 


Permuted Index 


end, etext, edata: last locations in 
mt: magnetic tape manipulating 
prompt: prompt 

sdiff: side-by-side difference 
STREAMS error logger cleanup 

units: conversion 

for the uucp file transport 

assert: verify 

ASSIST menus or command/ astgen: 
uucico: file transport 

installboot: installs a boot 

boot: run a standalone 

a standard/restricted command/ 

the standard/restricted command 
intro: introduction to Parallel 
maintenance commands and application 
update, and regenerate groups of 


lex: generate . 


setlocale: set 
prompt: 


t_getinfo: get 
proto: 


/monacct, nulladm, pretmp, prdaily, 
device 
standalone disk device 


streampty: STREAMS 

getpseudotty: get 

cn: 

generate uniformly distributed 
time, 

facility 

uuto, uupick: 

ungete: 

puts, fputs: 

pute, putchar, fputc, putw: 
getdents: read directory entries and 
echo: 

character or word on a stream 

or word on a stream pute, 
environment 


stream 

message: 

entry 

getut: getutent, getutid, getutline, 
pute, putchar, fputc, 

checkers 


program 
program 
program 
program. 
program. 
program 
program.. 
program assertion. 
program for generating/modifying.. 


-assert(3X) 
..astgen(1) 


program for the uucp system. uucico( 1M) 
program on a disk nstallboot(1M) 
program or bring up the operating system. ee 


programming language. 
programming language. 
Programming Library... 
programs... 
programs... 
programs for simple lexical tasks 
programs location......... 
prompt program........++- 
prompt: prompt program. 
proto: prototype job file for at. 
protocol-specific service information 
prototype job file for at.. 
prs: print an SCCS file... 
prtacct, shutacct, startup 
prtvtoc: print the VTOC of a block 
prtvtoc: print the VTOC of a 
ps: report process status.... 
pseudo termina] driver.. 
pseudo terminals.... 
pseudoconsole driver.. 
pseudorandom numbers... 
ptime: time a command... 
ptrace, mptrace: process trace. 
public UNIX-to-UNIX system file copy. 
push character back into input stream... 
put a string on @ StreaM.....eseseseee 
put character or word on a stream... 
put ina file system independent/. 
put string on virtual output... 
pute, putchar, fputc, putw: put.. 
putchar, fputc, putw: put character. 
putenv: change or add value to......... 
putmsg: send a message on a stream... 
putpwent: write password file entry. 


.prompt(1M) 
.prompt(1M) 
sseproto(4) 
..t_getinfo(3N) 


.prtvtoc(1M) 
.prtvtoc(8) 


...puts(3S) 
..pute(3S) 
..getdents(2) 
...echo(1F) 
putc(3S) 
..pute(3S) 
..putenv(3C) 
... putmsg(2) 
.putpwent(3C) 


puts, fputs: put a string on a... ...puts(3S) 
puts its arguments on message line. message(1F) 
putspent: write shadow password file... ..putspent(3X) 


pututline, setutent, endutent/.... 
putw: put character or word on a stream 
pwek, grpck: password/group file 


oe eae 
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/etce/shadow with information from/ 


database creation 
password entries 
one password file scheme 


tput: initialize a terminal or 

route user message to menu message 
msgget: get message 

Ipusers: set printing 

iperm: remove a message 
quotacheck: filesystem 


consistency checker 


quotaon, 

quotas on and off 

edquota: edit user 

quotactl: manipulate disk 
repquota: summarize 

quotaon, quotaoff: turn filesystem 
generator 

fsirand: install 

rand, srand: simple 

feplit: split [77, 


ratfor: 

scripts 

the operating system 
multi-user environment 


resintro: introduction to 

resfile: format of 

res: change 

sccstores;: build 

messages and other information about 
ci: check in 

co: check out 

resdiff: compare 

resmerge: merge 


commands 

getpass: 

of a common object file ldtbread: 
header of a/ ldshread, ldnshread: 
structure read_constab: 
file system independent/ getdents: 
read: 

mail, rmail: send mail to users or 
line: 
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pweonv: installs and updates.. 
pwd: working directory name. 
pwdhd: daemon to oversee password. 
pwfix: remove incorrectly formatted... 
pwunconv: converts from a two to a... 


..pweonv(1M) 


qsort: quicker SOFt......ssse0 -«qsort(3C) 
Query terminfo database .......s.ssscssssssssesreesssessreneeeseee tput(1) 
queue... menumsg(1M) 
queue... .-- Masgget(2) 
queue priorities. 

queue, semaphore set, or shared memory ID.......... iperm(1) 


quota consistency checkeF.......ssssecees quotacheck(1M) 


quota: display disk usage and limits ...........sescseseees quota(1) 
quotacheck: filesystem quota....... quotacheck(1M) 
quotact]: manipulate disk quotas.. -quotactl(2SEQ) 


quotaoff: turn filesystem quotas on and off.....quotaon(1M) 
quotaon, quotaoff: turn filesystem.. ..quotaon(1M) 
quotas... ..edquota(1M) 
quotas... .quotact](2SEQ) 
quotas for a filesystem.. 
quotas on and off.........00 
rand, srand: simple random-number. 
random inode generation numbers 
random-number generator.. 
ratfor, or efi files... 
ratfor: rational Fortran dialect.. 
rational Fortran dialect... 
re: reboot and shutdown command. 
rc0; run commands performed to stop.. 
re2: run commands performed for... 
res: change RCS file attributes. 
RCS commands. 


.-resintro(1) 
-resfile(4) 
+oeTC8(1) 


RCS revisions.. 
RCS revisions. 
RCS revisions.. 
RCS revisions.. 
resdiff: compare RCS revisions. ,< 


“co(1) 


resfile: format of RCS file....... resfile(4) 
resintro: introduction to RCS.. ..resintro(1) 
resmerge: merge RCS revisions... resmerge(1) 
read a password .. getpass(3C) 
read an indexed symbol table entry.. .-.ldtbread(3X) 
read an indexednamed section .ldshread(3X) 
read constab entries into a, ..read_constab(3SEQ) 
read directory entries and put ina -getdents(2) 


read from file.. 
read mail... 
read one line.. 


-read(2) 
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ldahread: 
ldfhread: 
readlink: 

ready: 

into a structure 
directory: opendir, 
gets longest line 
open a common object file for 
open: open for 
link 

readfile, longline: 


of an archive file 
object file 


lseek: move 

tirdwr: Transport Interface 
/get real user, effective user, 
/geteuid, getgid, getegid: get 
malloc, free, 
malloc, free, 
re: 
t_revudata: 
t_revuderr: 
t_rev: 
t_revconnect: 
lockf: 

ed, 

setcolor: 
ditsectbl: 
regular expression 


fast main memory/ 


over a connection 
connect request 


make; maintain, update, and 
expression regcmp, 
string 

and match routines 

regemp, regex: compile and execute 
regemp: 

regexp: 

a file for a pattern using full 


routines 


accept, 

comm: select or 

join: 

t_sndre]: initiate an orderly 
acknowledge receipt of an orderly 
common object file 

ldrseek, ldnrseek: seek to 
reloc: 

/ceil, fmod, fabs: floor, ceiling, 
calendar: 

uuxqt: execute 

Uutry: try to contact 

ct: spawn getty toa 
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read: read from file read(2) 


read the archive header of a membe: .ldahread(3X) 
read the file header of a common. Idfhread(3X) 
read value of a symbolic link readlink(2SEQ) 


read vector from file..........s:ssscsccessocsesessseeeverenee readv(2SEQ) 
read_constab: read constab entries.....read_constab(3SEQ) 
readdir, telldir, seekdir, rewinddir/.. .directory(3X) 
readfile, longline: reads file and. readfile(1F) 
ORGAN sissies nsncriscietscescecacisecessascesion 
reading or writing 
readlink: read value of a symbolic.. 
reads file and gets longest line 
readv: read vector from file 
read/write file pointer....... 
read/write interface STREAMS module. 


.-readfile(1F) 
-readv(2SEQ) 
..]seek(2) 
.tirdwr(7) 


real group, and effective group IDs .getuid(2) 
real user, effective user, real/.......... .getuid(2) 
realloc, calloc: main memory allocator -malloc(3C) 
realloc, calloc, mallopt, mallinfo........... malloc(3X) 


reboot and shutdown command scripts. 
TECCIVE A data UNIt.....cssesecesesesoerseaveres 
receive a unit data error indication... 
receive data or expedited data sent 
receive the confirmation from a... 
record locking on files.. 
red: text editor... 
redefine or create a color. 
refresh security table...... 
regcemp, regex: compile and execute 
regcmp: regular expression compile... 
regenerate groups of program........ 
regex: compile and exccute regular. 
regex: match patterns against a. 
regexp: regular expression compile. 
regular expressiOn.....-:ss0+s 
regular expression compile 
regular expression compile and match. 
regular CxpressionsS.......csesesers 
reinit: run an initialization file 
reject: allow or prevent LP requests... 
reject lines common to two sorted files. 
relational database operator 


t_revudata(3N) 
.t_revuderr(3N) 
-t_rev(3N) 


.comm(1) 
.Join(1) 


reloc: relocation information for a. 
relocation entries of a section of a common/. 
relocation information for a common object file...... reloc(4) 
remainder, absolute value functions.. 
TEMINEF SETVICE.........cereeeere 
remote command requests. 
remote system with debugging on 
remote terminal 
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rmdel: 
rmdir: 
rmvopt: 
iperm: 
unlink: 
rm, rmdir: 
pwfix: 
deroff: 


set, or shared memory ID 


password entries 


consistency check and interactive 
uniq: report 
clock: 
fsstat: 

ipes: 

df: 

mailbug: submit a bug 

sar: sal, sa2, sadc: system activity 
timex: time a command; 

ps: 

uniq: 

fseek, rewind, ftell: 

filesystem 

submit a bug report or enhancement 
t_accept: accept a connect 

t_listen: listen for a connect 

the confirmation from a connect 
send user-initiated disconnect 
accept, reject: allow or prevent LP 
the LP print service and move 
uuxqt: execute remote command 

Ip, cancel: send/cancel 
to its default values 
reset: 
get_process_stats: get 
restore: incremental filesystem 
restore 

/ksh, rksh — KornShell, a standard/ 
sh, rsh: shell, the standard/ 

shadow: 

/m_rele_procs: suspend and 

usage examples usage: 
t_revdis: 

object file symbol table/_ Idgetname: 
abs: 

logname: 

m_get_numprocs: 

m_get_myid: 
getenv: 

stat: data 
getitems: 
getfrm: 
cpus_online: 


facilities status 


default values 


marked menu items 
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remove a delta from an SCCS file. 
remove a directory..... 
remove a menu option.. 
remove a message queue, semaphore. 
remove directory entry.... 
remove files or directories... 
remove incorrectly formatte 
remove nroff, tbl, and eqn constructs.. 
rename: change the name of a file 
repair.. 
repeated lines in a file.. 
report CPU time used... 
report filesystem status 
report inter-process communication 


ri pwiix( 1M) 
..deroff(1) 
rename(2) 
fsck(1M) 
..uniq(1) 
.Clock(3C) 
fsstat(1M) 
.ipes(1) 


report number of free disk blocks and inodez............d(1M) 
report or enhancement requeSt...c.s.ssssessesessestseeee mailbug(1) 
report package 

report process data and system activity. timex(1) 
Teport process Status ....ssseee +» ps(1) 
report repeated lines in a file... wunig(1) 


..fseek(3S) 
-repquota(1M) 
«mailbug(1) 


reposition a file pointer in a stream. 
repquota: summarize quotas for a 
POQUER sinincavsnincensascrs ae 


request. accept(3N) 
request .t_listen(3N) 
request __revconnect(3N) 


requests.. 
requests. 
requests... 
requests to the LP print service. 
reset: reset the current form field. 
reset the current form field to its... 
resource utilization info get_process_ stats(2SEQ) 
-restore(1M) 
-restore(1M) 


restore: incremental filesystem. 
restricted command and programming/. 
restricted command programming/. 
restricted password file.......0.. 
resume child process execution. 
retrieve a command description an 
retrieve information from disconnect. 
retrieve symbol name for common... 
return integer absolute value. 
return login name of user.... 
return number of child procs.. 
return process identification 
return value for environment name. 


m_park_procs(3PPS) 
..usage(1) 
t_revdis(3N) 
dgetname(3X) 
bestaatal abs(3C) 
logname(3X) 
.m_get_numprocs(3PPS) 
..m_get_myid(3PPS) 
getenv(3C) 


returned by stat system call... stat(5) 
returns a list of the currently.. getitems(1F) 
returns the current frame number.. getirm(1F) 


returns the number of CPUs on-line.......cpus_online(3PPS) 
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col: filter 

ci: check in RCS 

co: check out RCS 

resdiff: compare RCS 

resmerge: merge RCS 

pointer in a stream fseek, 
/opendir, readdir, telldir, seekdir, 
creat: create a new file or 

restricted command/ ksh, 
information about RCS files 


chroot: change 

chroot: change 

logarithm, power, square 

queue menumsg: 
ldfen: common object file access 
regular expression compile and match 


reverse line-feeds. 


revisions... .i(1) 
revisions... .co(1) 
revision: -resdiff(1) 
revisions... resmerge(1) 
rewind, ftell: reposition a file... ....fseek(3S) 
rewinddir, closedir: directory/. .directory(3X) 
rewrite an existing one.......... ae 


rksh: KornShell, a standard/... 
rlog: print log messages and other. 
rm, rmdir: remove files OF.......:00000 
rmail: send mail to users or read mail. 
rmdel: remove a delta from an SCCS. 
rmdir: remove & directory... 
rmdir: remove files or directories 
rmvopt: remove a menu option 
TOOt CiTECLOTY.....ccsssosssseseseecasee 
root directory for a command. 
root functions. 
route user message 
routines.... 
routines... 


menu message 


programming language sh, rsh: shell, standard/restricted commands. 
nice: run a command at low priority .........s0s0 enice(1) 
nohup: run a command immune to hangups and quits.....nohup(1) 
shell: run a command using shell... .shell(1F) 
noage, nopff, noswap, onproc: run a command with priority aging, -noage(1M) 
the operating system boot: run a standalone program or bring up.. + boot(8) 
TUD! TUN AN CXCCULADIC......cececeresserereeeeeceeeen run(1F) 
ede: run an externally described command.. .ede(1M) 
reinit: run an initialization file... reinit(1F) 
setpgrp: run command in its own process group. setpgrp(1) 
multi-user environment re2: run commands performed for 
operating system rc0: run commands performed to stop the: 
runacct: run daily accounting.... 
run: run an executable 
runacct: run daily accounting....... 
Administration SA: devices administered by System. 
sar: sal, sa2, sadc: system activity report package sar(1M) 
sar:sal, sa2, sadc: system activity report package sar(1M) 
editing activity sact: print current SCCS file......ss0# sact(1) 
sar:sal,sa2, sadc: system activity report package. sar(1M) 
report package sar: sal, sa2, sadc: system activity... sar(1M) 
sar: system activity reporter..... .Sar(1) 
savecore: save a core dump of the operating system......savecore(1M) 
operating system savecore: save a core dump of the 
brk, sbrk: change data segment space allocation... brk(2) 
brk, sbrk: change private data segment size 
formatted input scanf, fscanf, sscanf: convert. 
fs: big file SCANMCT......sssscsssssesneeeceeseeeeneeee 
awk: pattern scanning and processing language.. 


nawk: pattern 
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change the delta commentary of an 
comb: combine 

delta: make a delta (change) to an 
get: get a version of an 

prs: print an 

rmdel: remove a delta from an 
scesdiff: compare two versions of an 
scesfile: format of 

sccstorcs: build RCS file from 
unget: undo a previous get of an 
val: validate 

sact: print current 

admin: create and administer 
what: identify 

SCCS file 


file 

board 

ckbupscd: check filesystem backup 
transport program uusched; the 
unlock locks s_init_lock, s_lock, 
object file 

image file 

more: view a file one full 

curses: terminal 

scr_dump: format of curses 

vi: 

inittab: 

re: reboot and shutdown command 
tg: 

sd: 

wd: SSM 

CCSformat: standalone embedded 
tm: 

ts: 

SCED: 

getscsiinfo, getscsimatch: get 


program 
fgrep: 

grep: 

full regular expressions egrep: 
bsearch: binary 

acctcom: 

lsearch, Ifind: linear 

pathconv: 

hcreate, hdestroy: manage hash 
tfind, tdelete, twalk: manage binary 
manipulate the object file comment 
m_multi: mark single-process code 
scnhdr: 

Adnshread: read an indexednamed 
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SCCs delta... 


SCCS file edi ing activity... 
SCCS files.. 


SCCS files what(1) 
secsdiff: compare two versions of an.. secsdiff(1) 
sccsfile: format of SCCS file............ sccsfile(4) 
sccstorcs: build RCS file from SCCS secstorcs(1) 
SCED: SCSV/Ethernet/Diagnostics..........ssessssesecseeenes sced(7) 
ckbupscd(1M) 
Pp -uusched(1M) 
s_clock, s_unlock: initialize, lock, . .8_lock(3PPS) 
senhdr: section header for a common. ..scnhdr(4) 
scr_dump: format of curses screen ..scr_dump(4) 
SCTCEN At A LIMC...ccccccoreereeeeseen osivieten .«more(1) 
screen handling and optimization package.........curses(3X) 
screen image file ......sssseesersseseeees ansnowasasnibeseaadransd scr_dump(4) 
screen-oriented (visual) display editor based on ex......vi(1) 
script for the init process. 
BOT OS sccassccscssaasccecenssiccecs 
SCSI 1/2-inch magnetic tape interface. 
SCSI disk controller..........00 a 
SCSI disk controller 


SCSI disk formatter. 
SCSI tape controller 
SCSI tape controller... 
SCSI/Ethernet/Diagnostics board. 
scsiinfo structure ........+ 


sd: SCSI disk controller. +80(7) 
sdiff: side-by-side difference. sdiff{1) 
search a file for a character string. igrep(1) 
search a file for a pattern........ grep(1) 
search a file for a pattern using. egrep(1) 
search a sorted table... search(3C) 
search and print process accounting files acctcom(1) 
Search and update ..esscssssessescsssereseesteneees lsearch(3C) 
search Interpreter criteria for filenam pathconv(1F) 
search tables... hsearch(3C) 
search trees.. tsearch(3C) 


section... 
section... 
section header for a common object file. 
section header of a common object... 


.ldshread(3X) 
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/seek to line number entries of a 
/seek to relocation entries of a 
/\dnsseek: seek to an indexednamed 
ditsectb]: refresh 

task: global 

tasktbl: create 


/orand48, mrand48, jrand48, srand48, 
acommon object/ Idsseek, ldnsseek: 
section of a/ ldlseek, ldnlseek: 

ldrseek, ldnrseek: 

a common object file ldohseek: 
object file Idtbseek: 
/opendir, readdir, telldir, 

sweepoff: enable/disable patrol 
shmget: get shared memory 

brk, sbrk: change private data 

shbrk, shsbrk: change shared data 
brk, sbrk: change data 
comm: 

greek: 

addformopt: add a form/ 
semctl: 

semop: 

iperm: remove a message queue, 
semget: get set of 


sorted files 


t_sndudata: 
putmsg: 
kill: 
t{notify: 
t_snd: 

mail, rmail: 
t_snddis: 
Ip, cancel: 
receive data or expedited data 
intro: introduction to 

dis386: disassemble 

SSM: System 

setsid: create 

ascii: map of ASCII character 
alarm: 

umask: 

stty, gtty: 

set, unset: 

sigstack: 

timezone: 
backup.info: backup 
setdtablesize: 

env: 


connection 


in core or in files 


50 


-ldlseek(3X) 
ldrseek(3X) 
ldsseek(3X) 
ditsectbl(1M) 


section of a common object file 
section of a common object file 
section of a common object file 
security table 


security table 

security table in shared memory. tasktbl(1M) 
GEA: SEEAM SAILOR wissscsacssszcassssssisaessececsnetesatesesesesassceaveet sed(1) 
seed48, lcong48: generate uniformly/. -drand48(3C) 
seek to an indexednamed section of... Idsseek(3X) 
seek to line number entries of a..... Idlseek(3X) 
seek to relocation entries of a section of a/........drseek(3X) 
seek to the optional file header of .ldohseek(3X) 
seek to the symbol table of a common -ldtbseek(3X) 
seekdir, rewinddir, closedir/. directory(3X) 
seeks on DCC disks. sweepon(1M) 
segment identifier .. shmget(2) 
segment size... .brk(3PPS) 
segment size «shbrk(3PPS) 


segment space allocation 
select or reject lines common to two... 
select terminal filter.....ssccssoseseees 
SELECT window option to a menu... 
semaphore control operations... 
semaphore operations... 


.comm(1) 
..greek(1) 
..addformopt(1M) 

.semctl(2) 


semaphore set, or shared memory ID iperm(1) 
ROMA PNOVER sncasessccsascnvccecssaseneceresennzers emget(2) 
semctl: semaphore control operations. semct](2) 
semget: get set of semaphores... ..semget(2) 
semop: Semaphore Operations .........secsssssercerseessers semop(2) 
send a data UNit...sseseoreere _sndudata(3N) 
send a message on a stream. putmsg(2) 


send a signal to a process or a group of processes......kill(2) 
send completion message. ..tfnotify(1M) 
send data or expedited data over a __snd(3N) 
send mail to users or read mail .-mail(1) 
send user-initiated disconnect request t_snddis(3N) 
send/cance] requests to the LP print service. 
sent over a connection. 
Sequent system calls 
Series 386 instructions 
Services Module.........+. 
session and set process group ID... 


....8sm(7) 


set a process alarm clock.. 
set and get file creation mask 
set and get terminal state (defunct). 
set and unset environment variables.. 
set and/or get signal stack contex' 
set default system time zone 
set definitions backup_info(4) 
set descriptor table size .setdtablesize(2SEQ) 
set environment for command execution.......cesrsereee env(1) 


igstack(2SEQ) 
timezone(4) 
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utime: 

umask: 

tcsetpgrp: 

setgroups: 

cpset: copy file and 

m_set_procs: 

semget: get 

remove a message queue, semaphore 
Ipusers: 

setpgrp: 

setsid: create session and 

setlocale: 

tabs: 

tegetattr, tesetattr: get/ 

line discipline getty: 
line discipline uugetty: 
date: print and 

stty: 

stime: 

environment variables in core or in/ 
setuid, setgid: 

ulimit: get and 

a stream 

/toascci, tolower, _toupper, 


size 
setuid, 
getgrent, getgrgid, getgrnam, 


crypt, 


/endmntent, getmntent, hasmntopt, 


process group 


getpwent, getpwuid, getpwnam, 
process group ID 

getspent, getspnam, 

profile: 

gettydefs: speed and terminal 
IDs 

user 

/getutid, getutline, pututline, 
setbuf, 

machine-independent fashion sputl, 
standard/restricted command/ 
/fgetspent, Ickpwdf, ulckpwdf: get 
putspent: write 


pwconv: installs and updates /etc/ 
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set file access and modification times.. .-Utime(2) 


set file-creation mode mask.... -umask(1) 
set foreground process group ID.. tesetpgrp(2) 
set group access list ..........sccseee .-8etgroups(2SEQ) 
Set mode, user, ANd Group IDS....se.esssssesseessesecsesessesvers cpset(1) 
set number of child processes... ..m_set_procs(3PPS) 
set of semaphoreS...........+ semget(2) 


set, or shared memory ID.. 
set printing queue priorities. 
set process group ID.... 
set process group ID. 
set programs location 
set tabs on a terminal 
set terminal state....... 
set terminal type, modes, speed, and 
set terminal type, modes, speed, and... 
Set the date .......cccscscsececssscseerses 
set the options for a terminal . 
BOL tHe. esrecossessensseeascecssonssoese 
set, unset: set and unset 


-setlocale(3C) 
tabs(1) 
.tegetattr(2) 


set user and group IDs vgetuid(2) 
set user limits........... ulimit(2) 
setbuf, setvbuf: assign buffering to setbuf(3S) 
setchrclass: character handling... ctype(3C) 
setcolor: redefine or create a color setcolor(1F) 
setdtablesize: set descriptor table.......setdtablesize(2SEQ) 
setgid: set user and group IDs setuid(2) 


setgrent, endgrent, fgetgrent: get group/ etgrent(3C) 
setgroups: set group access list......sssseeeee setgroups(2SEQ) 
setjmp, longjmp: non-local goto.......... wisesasatieassts setjmp(3C) 
setkey, encrypt: generate hashing encryption......crypt(3C) 
setlocale: set programs location. setlocale(3C) 


setmnt: establish mount table .....ssssssecsssseseessees setmnt(1M) 
setmntent: get file systen/...... -getmntent(3SEQ) 
setpgid: manipulate signal sets. ..8etpgid(2) 


setpgrp: run command in its ow: 
setpgrp: set process group ID...... 
setpwent, endpwent, fgetpwent: get/ .getpwent(3C) 
setsid: create session and set. setsid(2) 
setspent, endspent, f{getspent, Ickpwdf/........0+ getspent(3X) 
setting up an environment at login time .........0.00 profile(4) 
settings used by getty.....cssecssseeee gettydefs(4) 
setuid, setgid: set user and group... ..8etuid(2) 
setup: initialize system for first. --Setup(1) 
setutent, endutent, utmpname/. .getut(3C) 
setvbuf: assign buffering to a stream setbuf{3S) 
sgetl: access long integer data in a -sputl(3X) 


setpgrp(1) 
. Setpgrp(2) 


sh rahsebiell the ccs iscs sacacscseresnserecccstreremmmatecreareencueesees sh(1) 
shadow password file entry.. ..getspent(3X) 
shadow password file entry. .putspent(3X) 
shadow: restricted password file ase 


shadow with information fron... 


Permuted Index 


shbrk, shsbrk: change 

tasktbl: create security table in 
shmalloc, shrealloc, shfree: 
shmctl: 

a message queue, semaphore set, or 
shmop, shmat, shmdt: 

shmget: get 

segment size 

shell: run a command using 
assign menu system as user login 
system: issue a 

csh: a 

/shutacct, startup, turnacct: 


shells: 

command programming/ sh, rsh: 
shmalloc, shrealloc, 
memory allocator 
shmop, 

operations 

shmop, shmat, 
identifier 
operations 

the machine 
shmalloc, 

shbrk, 

shutdown: 
/nulladm, pretmp, prdaily, prtacct, 
re: reboot and 
shutdown: system 
system state 
information file 
actions 

sigemptyset, sigfillset, 


allocator 


manipulate/ 


sigemptyset, sigfillset, sigaddset, 
sigdelset, sigismember: manipulate/ 
sigismember/ sigemptyset, 
sigpause: signal management sigset, 
sigset, sighold, sigrelse, 

/sigfillset, sigaddset, sigdelset, 
sigsetjmp, 

login: 

pause: suspend process until 

specify what to do upon receipt of a 
sigsuspend: wait for a 

sigaction: examine and change 
sigcontext: get 

sigrelse, sigignore, sigpause: 

setpgid: manipulate 

sigdelset, sigismember: manipulate 
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..Shbrk(3PPS) 


shared data segment size 
...tasktbl(1M) 


shared memory... 
shared memory allocator 
shared memory control operations... 
shared memMOry ID .......ese0ee+ 
shared memory operations... 
shared memory segment identi shmget(2) 
shbrk, shsbrk: change shared data ..shbrk(3PPS) 
BION] sensssnscersesstecssssassscectedssave sansasecnessesssessessnsorssersssnsetes shell(1F) 


shell... tfmenush(1M) 
shell comman system(3S) 
shell (command interpreter) with C-like syntax........ esh(1) 


.acctsh(1M) 
....shell(1F) 
..shells(4) 
..8h(1) 


shell procedures for accounting 
shell: run a command using shell... 
shell table 
shell, the standard/restricted .. 


shells: shell table.....s.cceserseee ..Shells(4) 
shfree: shared memory allocator. shmalloc(3PPS) 


shmalloc, shrealloc, shfree: shared ........+0+0 shmalloc(3PPS) 
shmat, shmdt: shared memory opcrationsS........... 

shmct]: shared memory control 
shmdt: shared memory operations 
shmget: get shared memory segment 
shmop, shmat, shmdt: shared memory 
showcfg: show the configuration of... 
shrealloc, shfree: shared memory...... 
shsbrk: change shared data segment size 
shut down system, change system state. 
shutacct, startup, turnacct: shell/.. 


vshutdown( 1M) 
acctsh(1M) 


shutdown comMANGA SCTIPES...s.csssoreesseeesseneeseneersenessearensees re(4) 
shutdown information file.......00+. ..shutdown(4) 
shutdown: shut down system, change... ..Shutdown(1M) 
shutdown: system shutdowN.......ss .shutdown(4) 
sigaction: examine and change signal .. ..Sigaction(2) 
sigaddset, sigdelset, sigismember:. .sigemptyset(2) 
sigcontext: get signal context...... sigcontext(2SEQ) 
sigdelsct, sigismember: manipulate/ .sigemptyset(2) 
sigemptyset, sigfillset, sigaddset .sigemptyset(2) 
sigfillset, sigaddset, sigdelsct, . .sigemptyset(2) 
sighold, sigrelse, sigignore.,... -Sigsct(2) 
sigignore, sigpause: signal/.. .Sigset(2) 
sigismember: manipulate signal sets .Sigemptyset(2) 
siglongjmp: non-local jumps.... igsetjmp(3C) 
Jogin(1) 
ause(2) 
signal(2) 
igsuspend(2) 
iewtnend sigaction(2) 

signal context... 
signal management sigset(2) 


signal sets .. 
signal sets. 
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receipt of a signal 

sigstack: set and/or get 

kill: send a 

sigpending: examine pending 
examine and change blocked 
ssignal, gsignal: software 
sighold, sigrelse, sigignore, 


blocked signals 
signal management _sigset, sighold, 
sigignore, sigpause: signal/ 


jumps 

stack context 

atan2: trigonometric/ trig: 
m_single, m_multi: mark 

functions 


initialize barrier, wait at barrier 
s_unlock: initialize, lock, unlock/ 
sbrk: change private data segment 
getdtablesize: get descriptor table 
getpagesize: get system page 
setdtablesize: set descriptor table 
shsbrk: change shared data segment 
of object files 

interval 

interval 

s_init_lock, 

ttyslot: find the 

consmem, 

ssignal, gsignal: 

qsort: quicker 

tsort: topological 

sort: 


select or reject lines common to two 
bsearch: binary search a 
an object file list: produce C 


open file into the processs address 
unmap part of the processs address 
into processs virtual address 

brk, sbrk: change data segment 


memory efficient way 
fspec: format 

signal: 

getty: set terminal type, modes, 
uugetty: set terminal type, modes, 
gettydefs: 

find spelling errors 

file 
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: Spawn new process in a virtual... 


Permuted Index 


signal: specify what to do upon... signal(2) 
signal stack context. -Sigstack(2SEQ) 
signal to a process or a group of processes.. kill(2) 
BIQNAS bcscescscscccsteterennmtsiammaaauae .8igpending(2) 
signals.. .Sigprocmask(2) 


signals... -ssignal(3C) 
sigpause: signal manageMeNt....secececserecescreetsereres sigset(2) 
sigpending: examine pending signals.. -sigpending(2) 
sigprocmask: examine and change .Sigprocmask(2) 


.-Sigset(2) 
.-sigset(2) 
sigsetjmp(3C) 
-sigstack(2SEQ) 


sigrelse, sigignore, sigpause: 
sigset, sighold, sigrelse........ 
sigsetjmp, siglongjmp: non-local 
sigstack: set and/or get signal 
sigsuspend: wait for a signal .. 


Sin, COS, TAN, ASIN, ACOS, ALAN,......cccsescscererseeerererenenee trig(3M) 
single-process code section... m_single(3PPS) 
sinh, cosh, tanh: hyperbolic ........s.sscssssesesesseseseseeseers sinh(3M) 
s_init_barrier, s_wait_barrier: .8_wait_barrier(3PPS) 
s_init_lock, s_lock, s_clock,. _lock(3PPS) 


etdta esize(2SEQ) 
-getpagesize(2SEQ) 


sleep: suspend execution for an. 
sleep: suspend execution for... 
s_lock, s_clock, s_unlock: initialize, lock, 
slot in the utmp file of the current user, 
sm, ss: console memory drivers.. 
software signals. 


sort andor merge files... 
sort: sort and/or merge files 
sorted files... 
sorted table... 


source listing from. see C and Lang Tools Binder 
Sp: STREAMS pipe device ...s.ssscsssssssssersscsecssssessssesesseserseces sp(7) 
space... mmap(2SEQ) 
space... munmap(2SEQ) 
space.. «-pmap(7) 


space allocation... 
spawn getty to a remote terminal. 


specification in text files... 
specify what to do upon receipt of a signal... 
speed, and line discipline.. 
speed, and line discipline. 


-signal(2) 
..getty(1M) 
..uugetty(1M) 


speed and terminal settings used by getty.. gettydefs(4) 
spell, hashmake, spellin, hashcheckz........ ..8pell(1) 
spellhist: unmatched spelling Words.......sscssssss: spellhist(4) 
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spell, hashmake, 

hashmake, spellin, hashcheck: find 
spellhist: unmatched 

csplit: context 

split: 

fsplit: 


uucleanup: uucp 
printf, fprintf, 
data in a machine-independent/ 


square root/ exp, log, log10, pow, 
sqrt: exponential, logarithm, power, 
rand, 


/rand48, nrand48, mrand48, jrand48, 
consmem, sm, 
scanf, fscanf, 


wp: 
wd: 


terminal multiplexor driver 
sigstack: set and/or get signal 
copy: perform a 

prtvtoc: print the VTOC of a 


dual-channel disk/ zdformat: 
CCSformat: 

dump: 

operating system boot: run a 
intro: introduction to system 

stdio: 


stdipe: ftok: 

sh, rsh: shell, the 
operating system for beginning/ 
Ipsched, Ipshut, Ipmove: 

/pretmp, prdaily, prtacct, shutacct, 
call 


package 


stat: data returned by 
information 

ustat: get filesystem 

ff: list filenames and 

fsstat: report filesystem 
communication facilities 
ps: report process 

stat, Istat, fstat: get file 
feof, clearerr, fileno: stream 
uustat: uucp 

Ipstat: print information about the 
input/output package 
communication package 


waitpid: wait for a child process to 


54 


spellin, hashcheck: find spelling errors 
spelling errors....... 


split a file into pieces... 
split f77, ratfor, or efi files. 
split: split a file into pieces 
spool directory clean-up. 
sprintf: print formatted output... 
sputl, sgetl: access long integer... 
sqrt: exponential, logarithm, power,. 
square root functions... 
srand: simple random-number generator 
srand48, seed48, lcong48: generate/.. 
ss: console memory drivers. 


sscanf: convert formatted inpu scan{(3S) 
ssignal, gsignal: software signals ssignal(3C) 
SSM parallel line printer interface. - Wp(7) 


SSM SCSI disk controller....... 
SSM: System Services Module . 


st: Systech MTI-800/1600/1650 woe St(7) 
stack context... sigstack(2SEQ) 
standalone data transfer. a 


standalone disk device... 
standalone disk formatter fo: 
standalone embedded SCSI disk formatter... 
standalone Memory dUMP ...ccec-seeeeseeee 
standalone program or bring up the... 
standalone utilities... 
standard buffered input/output package.. 
standard interprocess communication 
standard/restricted command programming/. 


ecsformat(8) 


starter: information about the starter(1) 
start/stop the LP print service and move/.........lpsched(1M) 
startup, turnacct: shell procedurev/.... acctsh(1M) 


stat: data returned by stat system... 
stat, Istat, fetat: get file status... 
stat system Call .....ssceeesee 
statfs, fstatfs: get filesystem. 
statistics. 


.Statfs(2) 
..ustat(2) 


Statistics for a filesyStem .....sesecsessssseescsrersesesereeseonensnsane (1M) 
SCALUS ...cccsscesseceseeseneeee .fsstat(1M) 
status. ipes(1) 
status.. «ps(1) 
status. stat(2) 


..ferror(3S) 
uustat(1C) 
Ipstat(1) 
..Stdio(3S) 
.stdipe(3C) 
.Stime(2) 
.--Wait(2) 


status inquiries.. 
status inquiry and job contro 
status of the LP print service.. 
stdio: standard buffered..... 
stdipe: ftok: standard interprocess. 
stime: set time..... 
stop or terminate 
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Ipsched, Ipshut, Ipmove: start/ 
rc0: run commands performed to 
icheck: filesystem 


strncmp, strepy, strncpy/ string: 
/strnemp, strepy, strncpy, strlen, 
cleanup program 

string: streat, strdup, strncat, 
/strdup, strncat, stremp, strncmp, 
/strchr, strrchr, strpbrk, strspn, 
strepy, strncpy,/ string: streat, 
fclose, flush: close or flush a 

fopen, freopen, fdopen: open a 
reposition a file pointer in a 

getw: get character or word from a 
getmsg: get next message off a 

gets, fgets: get a string froma 

putw: put character or word on a 
putmsg: send a message on a 

puts, fputs: put a string on a 

setvbuf;: assign buffering to a 

push character back into input 

sed: 

ferror, feof, clearerr, fileno: 


driver 

clone: open any minor device on a 
strelean: 

strerr: 

log: interface to 

poll: 

streamio: 

Transport Interface cooperating 
Interface read/write interface 
8p: 

streampty: 

strace: print 

streamtty: Generic 

1d0: 

driver interface 


long integer and base-64 ASCII 
tzset: convert date and time to 
convert floating-point number to 
fgrep: search a file for a character 
regex: match patterns against a 
gps: graphical primitive 

gets, fgets: get a 

puts, fputs: put a 

echo: put 

strpbrk, strspn, strespn, strtok: 
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..lpsched(1M) 
..rc0(1M) 
icheck(1M) 
.strace(1M) 
String(3C) 
..String(3C) 
.strclean(1M) 
..string(3C) 
..String(3C) 


stop the LP print service and move/.. 
stop the operating system... 
storage consistency check... 
strace: print STREAMS trace messages... 
streat, strdup, strncat, strcmp..... 
strehr, strrehr, strpbrk, strspn/.. 
strclean: STREAMS error logger... 
stremp, strncmp, strepy, strnepy,/. 
strepy, strnepy, strlen, strchr/.. 
strespn, strtok: string operations. 
strdup, strncat, strcmp, strncmp, 
stream... 


stream fopen(3S) 
stream. fseek(3S) 
stream. »gete(3S) 
stream. getmsg(2) 
stream. .gets(3S) 


..putmsg(2) 
«10 puts(3S) 
.setbuf(3S) 
stream... -ungetc(3S) 
StTEAM CAItOL.........csssscessserserescenssccecessccesesssscsssaresesasoneeese sed(1) 
stream status inquiries... . ferror(3S) 
streamio: STREAMS ioct] commands... 
streampty: STREAMS pseudo terminal .. 
STREAMS driver. 


STREAMS error logger cleanup program «strelean(1M) 
STREAMS error logger daemon..........1+04 .strerr(1M) 
STREAMS error logging and event tracing... log(7) 
STREAMS input/output multiplexing......cessssseeeerese poll(2) 
STREAMS ioct] commands 


STREAMS module 
STREAMS module 


STREAMS trace messages... »Strace(1M) 
STREAMS tty driver interface .streamtty(7) 
STREAMS tty line discipline .....cssssssssesssserssscsncesessarsacee 1d0(7) 
streamtty: Generic STREAMS tty... .Streamtty(7) 
strerr: STREAMS error logger daemon .strerr(1M) 
strftime: format time information... .strftime(3C) 


SEPA Bis scscs cetesercecassicxssivacctaseniesesesciias .264](3C) 
string... .ctime(3C) 
string 5 

string.. 

string..... 


string, format of graphical files. . 
string from a stream a 
string on a stream. +. puts(3S) 


string on virtual output... -echo(1F) 
string operations .-string(3C) 
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strcmp, strnemp, strcpy, strncpy/ 
strtod, atof: convert 

strtol, atol, atoi: convert 

cftime: language specific 

object file 

/stremp, strncmp, strepy, strncpy, 
string: strcat, strdup, 

/streat, strdup, strncat, stremp, 
/strncat, stremp, strncmp, strepy, 
/strncpy, strlen, strchr, strrchr, 
/strepy, strncpy, strlen, strehr, 
/strlen, strchr, strrchr, strpbrk, 
character 

double-precision number 

strrehr, strpbrk, strspn, strespn, 
to integer 

processes using a file or file 
getscsimatch: get scsiinfo 
getzdinfobyname: get zdinfo 
read constab entries into a 
t_alloc: allocate a library 

t_free: free a library 

state (defunct) 


backup.codes1: backup 

m_fork: execute a 

dbm_clearerr, dmb_blkflush: database 
plot: graphics interface 

sulog: log of 


of a file 

du: 

repquota: 

acctems: command 
s_init_lock, s_lock, s_clock, 
sync: update the 

sync: update 

su: become 

getgroups: get 

uucp: networking 

lptypes: table of printer types 
m_park_procs, m_rele_procs: 
sleep: 

sleep: 

pause: 


records 


s_init_barrier, 
swap: 
swab: 


wait at barrier 


/a command with priority aging, PFF, 
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string: streat, strdup, strncat, ..... 
string to double-precision number.. 


strlen, strchr, strrchr, strpbrk/... 
strncat, stremp, strnemp, strepy, strncpy/.. 
strnemp, strepy, strncpy, strlen/. 
strncpy, strlen, strchr, strrchr/... 
strpbrk, strspn, strespn, strtok/..... 
strrehr, strpbrk, strspn, strcspn/. 
strspn, strespn, strtok: string/.. 
strstr: find first occurrence o 
strtod, atof: convert string to 
strtok: string operations....... 
strtol, atol, atoi: convert string 
structure.. 
structure... 
structure .. 
structure... 
structur 
structure... 
stty, gtty: set and get terminal....... 
stty: set the options for a terminal. 
su: become superuser or another use 
subcode definitions... 
subprogram in paralle’ 
subroutines... 
subroutines... 
substitute user events 
sulog: log of substitute user events. 
sum: print checksum and block count 
summarize disk usage... 
summarize quotas for a filesystem 
summary from per-process accounting 
s_unlock: initialize, lock, unlock locks... 
superblock... 
superblock... 
superuser or another user. 
supplementary group IDs. 
SUpPPOTt fileS,.......s.se0eeeeeee 
supported by the menu system 
suspend and resume child processy.....m.  park_procs(3PPS) 
suspend execution for an interval .-Sleep(1) 
suspend execution for interval. 
suspend process until signal.. 
swab: swap bytes. 
s_wait_barrier: initialize barrier, 


..read_constab(3SEQ) 
.t_alloc(3N) 
..t_free(3N) 


«sum(1) 
-du(1M) 
repquota(1M) 
.acctcms(1M) 
.s_lock(3PPS) 


pause(2) 
swab(3C) 
s_wait_barrier(3PPS) 


swap: swap administrative interface... 


swapping, or processor migration/ -noage(1M) 
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seeks on DCC disks sweepon, 
patro] seeks on DCC disks 

symbol table/ dgetname: retrieve 
symbol name for common object file 
ldtbindex: compute the index of a 
ldtbread: read an indexed 

syms: common object file 

ldtbseek: seek to the 

unistd: file header for 

readlink: read value of a 

symlink: make 

of common operating system terms and 
file 

table format 


controlling FMLI object vsig: 
t_sync: 

check documents for correct eqn 
(command interpreter) with C-like 


administration 


variables 
configuration file 
perror, errno, 


menu system functions 

perror, errno, sys_errlist, 
multiplexor driver st: 
lp: 

bsearch: binary search a sorted 
constab: constructed devices 
devtab: virtual device 

ditsectbl: refresh security 

kernel auto-configuration device 
fstab: file-system- 

mnttab: mounted filesystem 
setmnt: establish mount 

shells: shell 

task: global security 

name for common object file symbol 
/compute the index of a symbol 
ldtbread: read an indexed symbol 
syms: common object file symbol 
tasktbl: create security 

get maximum in-use descriptor 
ldtbseek: seek to the symbol 

the menu system lptypes: 
getdtablesize: get descriptor 
setdtablesize: set descriptor 
classification and conversion 
hdestroy: manage hash search 
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sweepoff: enable/disable patrol 
sweepon, sweepoff: enable/disable 
symbol name for common object file 
symbol table entry..... 
symbol table entry of a common/.. 
symbol] table entry of a common object... 
symbol] table format......cssccssssescsesoneeesseeee 
symbol table of a common object file 
symbolic constants. 


20 “ldgetname(3X) 
.. ldgetname(3X) 
ldtbindex(3X) 
..ldtbread(3X) 


..ldtbseek(3X) 
— unistd(4) 


symbolic link ......... readlink(2SEQ) 
symbolic link to a file symlink(2SEQ) 
BYMDOS sassvsiessssecosesssassusnsssorsssessanvees glossary(1) 


symlink: make symbolic link to a. 
syms: common object file symbo’ 
syne: update superblock......... 
sync: update the superblock... 
synchronize a co-process with the 
synchronize transport library... 


ae 


SY TUR va casssacenavisasacacaaiesascencessimasaitsssnsssbesceabitawimonsinesions esh(1) 
sysadm: menu interface to do system.. sysadm(1) 
syscall; indirect system call....... .syscall(2) 
sysconf: get configurable system. -syscon{(2) 
sys_config: format of a system....... . 8ys_config(4) 
sys_errlist, sys_nerr: system error messages......perror(3C) 
sysi86; machine specific functions. sysi86(2) 
syskeymap: identify keys to interna! syskeymap(4) 
sys_nerr: system error messages...... perror(3C) 
Systech MTI-800/1600/1650 terminal.. 8t(7) 
Systech parallel line printer interface ~1p(7) 
aviunusnaeeveren bsearch(3C) 
constab(4) 

.-devtab(4) 

-ditsectbl(1M) 

dumpconf(1M) 

gespsad fstab(4) 

munttab(4) 

setmnt(1M) 

shells(4) 

Bete task(4) 

dgetname(3X) 

table entry of a common object file .ldtbindex(3X) 
table entry of a common object file ..ldtbread(3X) 
table format scsscscsscssasssstssccatsiastesessesseansocnecnssursacasonassannd syms(4) 
table in shared memory... tasktbl(1M) 
table index .....sssecssseseee ..getdtablemax(2SEQ) 
table of a common object file.. ldtbseek(3X) 
table of printer types supported by... ...lptypes(4) 
table size... getdtablesize(2SEQ) 
table size.. setdtablesize(2SEQ) 
(1 8) [eee pe ep eee ee ER chrtbl(1M) 
.-hsearch(3C) 
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tabs: set 


ctags: create a 

file 

structure 

trig: sin, cos, 

sinh, cosh, 

tm: SCSI 

ts: SCSI 

hpio: Hewlett-Packard 2645A terminal 
tar: 

mtio: UNIX magnetic 

tg: SCSI 1/2-inch magnetic 

xt: Xylogics 472 MULITBUS magnetic 
mt: magnetic 


shared memory 
transport endpoint 
deroff: remove nroff, 
terminal state 


group ID 


with another transport user 
tegetattr, 

group ID 

tsearch, tfind, 


4014: paginator for the 


init, 
directory: opendir, readdir, 
temporary file tmpnam, 


tmpfile: create a 

tmpnam, tempnam: create a name for a 
terminals 

term: format of compiled 


captoinfo: convert a 
base 

paginator for the Tektronix 4014 
special functions of the DASI 450 
ct: spawn getty to a remote 
ctermid: generate filename for 
hangup the specified controlling 
stty: set the options for a 

tabs: set tabs on a 

tty: get the name of the 

ttyname, isatty: find name of a 
/associated with a terminal or the 
termcap: 
terminfo: 


description 
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.task: global security table 


tabs on a terminal 
tabs: set tabs on a terminal. 
t_accept: accept a connect request. 


tail: deliver the last part of a 
t_alloc: allocate a library 
tan, asin, acos, atan, atan2: trigonometric/. 
tanh: hyperbolic functions... 
tape controller.. 
tape controller. 
tape file archiver 
tape file archiver.... 
tape interface... 
tape interface. 
tape interface... 
tape manipulating program 
tar: tape file archiver....... 


tasktbl: create security table in 
t_bind: bind an address to a 
tbl, and eqn constructs..... 
tegetattr, tcsetattr: get/se 
tegetpgrp: get foreground process..... 
t_close: close a transport endpoint 
t_connect: establish a connection. 
tesetattr: get/set terminal state. 
tesetpgrp: set foreground process... 
tdelete, twalk: manage binary search trees... 


..tegetattr(2) 
tegetpgrp(2) 
..t_close(3N) 
.t_connect(3N) 
.tegetattr(2) 
tcsetpgrp(2) 
.tsearch(3C) 


tee: pipe fitting......ssssssesssecacsesscececensssnensenensssnnensens tee(1) 
Tektronix 4014 termina -4014(1) 
telinit: process control initialization. init(1M) 
telldir, seekdir, rewinddir/......... . directory(3X) 
tempnam: create a name fora tmpnam(3S) 
temporary file... .tmpfile(3S) 
temporary file... tmpnam(3S) 
term: conventional names for. ..term(5) 
term file......essscesscesssercersseneesees .term(4) 
term: format of compiled term file -term(4) 
termcap description into a terminfo. captoinfo(1M) 
termcap: terminal capability data ..termceap(4) 


terminal. .4014(1) 


terminal. 450(1) 
terminal... .ct(1C) 
terminal... ctermid(3S) 


terminal.. 
terminal... 
terminal.. 
terminal.. 
terminal... 
terminal associated with a device.. 
terminal capability data base.. 
terminal capability database.. 


weet y(1) 
..ttyname(3C) 
..ttydevname(1) 
.termeap(4) 
.terminfo(4) 
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streampty: STREAMS pseudo 

greek: select 

tty: controlling 

termio: general 

dial: establish an out-going 

st: Systech MTI-800/1600/1650 

xs: Xylogics 781 

tput: initialize a 

/get the device associated with a 
optimization package curses: 
gettydefs: speed and 

tegetattr, tcsetattr: get/set 

stty, gtty: set and get 

hpio: Hewlett-Packard 2645A 

line discipline getty: set 
line discipline uugetty: set 
functions of DASI 300 and 300s 
getpseudotty: get pseudo 

special functions of Hewlett-Packard 
term: conventional names for 

wait for a child process to stop or 
kill: 

exit, _exit: 

tic: 

tput: initialize a terminal or query 
convert a termcap description into a 
infocmp: compare or print out 
database 


of common operating system 


isnan: isnand, isnanf: 

ed, red: 

ex: 

edit: 

errormsg: error message 

newform: change the format of a 
fspec: format specification in 
isismgr: ISIS file manager, updates 
plock: lock process, 
tsearch, 

reporter 

login shell 


search trees 


interface 
service information 


merge: 


batch: execute commands at a later 


DYNIX /ptx Reference Manual 


Permuted Index 


terminal driver. 
terminal filter... 
terminal (gentty) interface. 
terminal interface......... 
terminal line connection... 
terminal multiplexor driver. 
terminal multiplexor driver ........css0 
terminal or query terminfo database... 
terminal or the terminal associated/.. 
terminal screen handling and. 
terminal settings used by getty. 
terminal state... 
terminal state (defunct), 
terminal tape file archiver.. 
terminal type, modes, speed, and. 
terminal type, modes, speed, and... 
terminals. 
terminals 
terminals. 
terminals... 
terminate... 
terminate a process 
terminate process... 
terminfo compiler... 
terminfo database.. 
terminfo description 
terminfo descriptions 
terminfo: terminal capability. 
termio: general terminal interface. 
terms and symbols. 

t_error: produce error message.. 
test: condition evaluation command 
test for floating-point Nal/..........0. 
text editor.. 
text editor... 
text editor (variant of ex for casual users).. 
text file... 


-gettydefs(4) 
.tegetattr(2) 


.terminfo(4) 
-termio(7) 
..glossary(1) 
.t_error(3N) 
...test(1) 
-isnan(3C) 


errormsg(4) 
-newform(1) 
--fspec(4) 
isismgr(1M) 
plock(2) 
.tsearch(3C) 


text files.. 
text files in ISIS file format.. 
text, or data in memory 
tfind, tdelete, twalk: manage binary. 
tfipe: interprocess communication... 
tfmenush: assign menu system as user 
tfnotify: send completion message 
t_free: free a library structure... 
tg: SCSI 1/2-inch magnetic tape. 


tfnotify(1M) 
t_free(3N) 
tg(7) 


t_getinfo: get protocol-specific. .t_getinfo(3N) 
t_getstate: get the current state __getstate(3N) 
three-way file merge. merge(1) 

i -tic(1M) 


Permuted Index 


view a file one full screen at a 


setting up an environment at login 
stime: set 

time: get 

time, ptime: 

and system activity timex: 
acctcon1, acctcon2: connect- 


strftime: format 
profil: execution 


mktime, tzset: convert date and 
clock: report CPU 

timezone: set default system 

times: get process and child process 
set file access and modification 
times 

update access and modification 
process data and system activity 
zone 

cooperating STREAMS module 
read/write interface STREAMS module 
request 

a transport endpoint 


processor 


temporary file 

fisgraph, isascii, tolower, toupper, 
/tolower, _toupper, _tolower, 

conv: toupper, tolower, _toupper, 
Jisascii, tolower, toupper, toascci, 
/ispunct, isprint, isgraph, isascii, 
conv: toupper, 

endpoint 

tsort: 

transport endpoint 

acctmerg: merge or add 
modification times of a file 
/tolower, toupper, toascci, _tolower, 
/isprint, isgraph, isascii, tolower, 
conv: toupper, tolower, 

_tolower, toascii: translate/ conv: 
terminfo database 


ptrace, mptrace: process 

strace: print STREAMS 

to STREAMS error logging and event 
copy: perform a standalone data 
init.d: system level 

_toupper, _tolower, toascii: 
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time. ...-more(1) 
time. 

time.. 

time.. ..time(2) 
time a command ..time(1) 
time a command; report process data... timex(1) 
time accounting.. acctcon(1M) 


time: get time... 
time information 
time profile 
time, ptime: time a command... 
time to string 
time used... 


times 
times: get process and child process... 
times of a file .....ssesssesesesseseeenees 
timex: time a command; report. 
timezone: set default system time.. 
timod: Transport Interface... 
tirdwr: Transport Interface 
t_listen: listen for a connect... 
t_look: look at the current event on.. 
tm: SCSI tape controller 
tmp_affinity: bind a process to a. 
tmp_ctl: multi-processor control. 
tmpfile: create a temporary file... 
tmpnam, tempnam: create a name for a. 
toascci, _tolower, _touppery... 
toascii: translate characters. 
_tolower, toascii: translate/...... 
_tolower, _toupper, setchrclass:/. 
tolower, toupper, toascci, _tolower, 
tolower, _toupper, _tolower, toascii: translate/. 
t_open: establish a transport 
topological sort..... 
t_optmgmt: manage options for a 
total accounting files.... 
touch: update access and.... 
_toupper, setchrclass: character/. 
toupper, toascci, _tolower/ .....000» 
_toupper, _tolower, toascii: translate/. 
toupper, tolower, _touppe, .....s.e.e00 
tput: initialize a terminal or query 
tr: translate characters 
trace facility 
trace messages. 
tracing... 
transfer 
transition files directory... 
translate characters...... 


t_listen(3N) 


tmp_affinity(2SEQ) 
..tmp_ctl(2SEQ) 
tmpfile(3S) 
tmpnam(3S) 
.ctype(3C) 
..conv(3C) 
..conv(3C) 
.ctype(3C) 
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tr: 

t_bind: bind an address to a 

t_close: close a 

look at the current event on a 
t_open: establish a 

t_optmgmt: manage options for a 
t_unbind: disable a 

STREAMS module timod: 
interface STREAMS module _ tirdwr: 
t_sync: synchronize 

the scheduler for the uucp file 
uucico: file 

establish a connection with another 
data sent over a connection 
confirmation from a connect request 
disconnect 

orderly release indication 


error indication 

ftw: walk a file 

tdelete, twalk: manage binary search 
atan, atan2: trigonometric/ 

cos, tan, asin, acos, atan, atan2: 


truncate, ftruncate: 

to a specified length 

u3b2, u3b5, vax: get processor type 
true, false: provide 


manage binary search trees 
over a connection 
disconnect request 

release 


library 
interface 
streamtty: Generic STREAMS 


1d0: STREAMS 

between major/minor numbers and 
associated with a terminal or the/ 
terminal 
dev_to_ttyname, 

file of the current user 
endpoint 

vmtune: 

tunefs: 

filesystem 

examine and change virtual memory 
/prdaily, prtacct, shutacct, startup, 
tsearch, tfind, tdelete, 


major/minor/ 


parameters 
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translate characters... 
transport endpoint... 
transport endpoint... 
transport endpoint... 
transport endpoint... 
transport endpoint.. 
transport endpoint 
Transport Interface cooperating. 
Transport Interface read/write.. 
transport library.. 
transport program... 
transport program for the uucp system... 
TFANSPOTt USET.....eserereeeeeee 
t_rev: receive data or expe: " 
t_revconnect: receive the... 
t_revdis: retrieve information from.. 
t_revrel: acknowledge receipt of an... 
t_revudata: receive a data unit. 


..t_bind(3N) 
.t_close(3N) 
t_look(3N) 
..t_open(3N) 
.t_optmgmt(3N) 
.t_unbind(3N) 


“t _syne(3N) 
..uusched(1M) 
..uucico(1M) 
t_connect(3N) 

...t_rev(3N) 
revconnect(3N) 
t_revdis(3N) 
.t_revrel(3N) 
.t_revudata(3N) 


t_revuderr: receive a unit data.. .t_revuderr(3N) 
tFe@....00. sseseeeftw(3C) 
tree: tsearch(3O) 


trig: sin, cos, tan, asin, acos, 
trigonometric functions.. 
true, false: provide truth values ......csssecsssssscssesssceseees true(1) 
truncate a file to a specified length 
truncate, ftruncate: truncate a file 
truth value 
truth values... 

ts: SCSI tape controller. 
tsearch, tfind, tdelete, twalk: 
t_snd: send data or expedited data 
t_snddis: send user-initiated... 
t_sndrel: initiate an orderly. 
t_sndudata: send a data unit 
tsort: topological sort ......00. 
t_sync: synchronize transport. 
tty: controlling terminal (gentty’ 
tty driver interface .....ssessseee 
tty: get the name of the terminal 
tty line discipline.. 
tty names............ 
ttydevname: get the device 
ttyname, isatty: find name of a... ttyname(3C) 
ttyname_to_dev: convert between.......dev_to_ttyname(3C) 
ttyslot: find the slot in the utmp......ccssssssescsssssese ttyslot(3C) 
t_unbind: disable a transport .. t_unbind(3N) 
tune system-wide virtual-memory.. «vmtune(1M) 


tsearch(3C) 
+-t_snd(3N) 
__snddis(3N) 
«t_sndrel(3N) 
t_sndudata(3N) 


..dev_to. _ttyname(3C) 
Sevnnnicied ttydevname(1) 


tune up an existing filesystem . tunefs(1M) 
tunefs: tune up an existing....... .tunefs(1M) 
tuning parameters... vm_ctl(2SEQ) 


turnacct: shell procedures for’... 
twalk: manage binary search trees 


-acctsh(1M) 
...tsearch(3C) 
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types: primitive system data 
Iptypes: table of printer 

/asctime, cftime, ascftime, mktime, 
machid: i386, ns32000, pdp11, 
machid: i386, ns32000, pdp11, u3b, 
Ai386, ns32000, pdp11, u3b, u3b2, 
/endspent, fgetspent, Ickpwdf, 
mask 


mount, 


mountall, 
system 


filesystems 


expand data compress, 
unget: 

SCCS file 

input stream 

file 

mktemp: make a 
constants 
t_revudata: receive a data 
t_sndudata: send a data 
t_revuderr: receive a 


mtio: 

cu; call another 

link, unlink: link and 
link, 


m_lock, m_unlock: lock, 

s_clock, s_unlock: initialize, lock, 
space munmap: 
spellhist: 

umount: 

mount, umount: mount and 
mountall, umountall: mount, 

pack, peat, 

set, unset: set and 

variables in core or in files set, 
lsearch, Ifind: linear search and 
touch: 

make: maintain, 

bdflush: 

bdflush: 

sync: 

sync: 


from/ pweonv: installs and 
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types supported by the menu system 
tzset: convert date and time to/.. 
u3b, u3b2, u3b5, vax: get processor 
u3b2, u3b5, vax: get processor type/.. 
u3b5, vax: get processor type truth... 
uadmin: administrative control . 
uadmin: administrative control.. 
ulckpwdf: get shadow password file entry........ 
ulimit: get and set user limits 
umask: set and get file creation.. 
umask: set file-creation mode mask.. 
umount: mount and unmount filesystems... 
umount: unmount a filesystem 
umountall: mount, unmount multiple.. 
uname: get name of current operating. 
uname: print name of current system... 
uncompress, zcat: compress and... 
undo a previous get of an SCCS file 
unget: undo a previous get of an.... 
ungetc: push character back into 


ulimit(2) 


-umask(1) 


“ungete(3S) 


uniq: report repeated lines ina + uniq(1) 
unique filename ....sssceeseseeeen «mktemp(3C) 
unistd: file header for SyMboO]iC.....cssseseseseeeesearereees unistd(4) 
unit .t_revudata(3N) 
unit... t_sndudata(3N) 
unit data error indication... .t_revuderr(3N) 


units: conversion program 
UNIX magnetic tape interface . 
UNIX system 
unlink files and directories........esccsssseseenes 
unlink: link and unlink files and directories.. 
unlink: remove directory entry. 
unlock locks... 
unlock locks... 
unmap part of the processs address.. 
unmatched spelling words file 
unmount a filesystem.. 
unmount filesystems... 
unmount multiple filesystems.. 
unpack: compress and expand files..... 
unset environment variables in core or in files... 
unset: set and unset environment 
update 
update access and modification times of a file 


s_lock(3PPS) 
..munmap(2SEQ) 
spellhist(4) 
umount(2) 
mount(1M) 
mountall(1M) 


update, and regenerate groups of programs 
update daemon... _bdflush(1M) 
update daemon.. oo 


update superblock.. 
update the superblock. 


updates /etc/shadow with information -pweonv(1M) 
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isismgr: ISIS file manager, 

been up 

du: summarize disk 

quota: display disk 

retrieve a command description and 
description and usage examples 


getusclk, 

get character login name of the 
logname: return login name of 
setup: initialize system for first 

su: become superuser or another 

a connection with another transport 
slot in the utmp file of the current 
write: write to another 

cpset: copy file and set mode, 
setuid, setgid: set 

id: print 

crontab: 

addusr.def: add 

/geteuid, getgid, getegid: get real 
environ: 

run commands performed for multi- 
sulog: log of substitute 

generate disk accounting data by 
ulimit: get and set 

tfmenush: assign menu system as 
menumsg;: route 

edquota: edit 

/getegid: get real user, effective 
t_snddis: send 

editor (variant of ex for casual 

the operating system for beginning 
wall: write to all 

ut_delete_user: add/delete 

mail, rmail: send mail to 

login attempts 


add/delete users in utmp file 

utmp file ut_add_user, 
introduction to system standalone 
get_process_stats: get resource 
modification times 

utmp, wtmp: 

ut_delete_user: add/delete users in 
endutent, utmpname, getutpid: access 
ttyslot: find the slot in the 

formats 

/pututline, setutent, endutent, 

and permissions file 

the uucp system 

clean-up 
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updates text files in ISIS file format. .......s.:ss pes ie 
uptime: show how long system has... 
USAGE vesserereroseeee 
usage and limits. 
usage example: 
usage: retrieve a comman 
usclk: 32-bit microsecond counter. 
usclk_init: get/init microsecond clock 
user... 
user.. 
user. 
user. 
user. 
user... 
user... 
user, and group IDs 
user and group IDs.... 
user and group IDs and names... 
user crontab file... 


_connect(3N) 
ttyslot(3C) 
.write(1) 


crontab(1) 


user defaults........ -addusr_def(4) 
user, effective user, real group, + getuid(2) 
user environment.. environ(5) 
user environment. ssoeoereTC2(1M) 
user events ++. 8ulog(4) 
user ID... diskusg(1M) 
NISC RI MIIES, snsiosssscaconsnuascvncsessssscossosceitsisnisecsieessitensceaed ulimit(2) 
user login shell .tfmenush(1M) 


user message to menu message queue 
user quotas..., 
user, real group, and effectivel.. 
user-initiated disconnect request. 
users).. 
users 
users... 

users in utmp file 
users or read mail... 
/usr/adm/loginlog: log of failed/.. 
ustat: get filesystem statistics 
ut_add_user, ut_delete_user:. 
ut_delete_user: add/delete users in.. 
utilities. 


intro(8) 
get_process_stats(2SEQ) 


utmp and wtmp entry formats .-utmp(4) 
atin fll cssssscsccserseetscensassasonsasenss utadduser(3X) 
RUNES SN sracasssscessciseinsissvenisassapssveanaviesomssnninnen getut(3C) 


utmp file of the current user. 
utmp, wtmp: utmp and wtmp entry 
utmpname, getutpid: access utmp file/, 
uucheck: check the uucp directories. 
uucico: file transport program for. 
uucleanup: uucp spool directory 


ttyslot(3C) 
...utmp(4) 
getut(3C) 
uucheck(1M) 
«-uucico(1M) 
.-uucleanup(1M) 
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uucheck: check the 
uusched: the scheduler for the 


uucleanup: 

uustat: 

file transport program for the 
UNIX-to-UNIX system/ 
speed, and line discipline 
uucp, 

uucp, uulog, 

uuto, 

file transport program 
control 

UNIX-to-UNIX system/ 

with debugging on 

system command execution 
requests 


val: 


abs: return integer absolute 

u3b5, vax: get processor type truth 
getenv: return 

floor, ceiling, remainder, absolute 
readlink: read 

putenv: change or add 

current form field to its default 
true, false: provide truth 

values: machine-dependent 


print formatted output of a 

list 

varargs: handle 

fpathconf: get configurable pathname 
sysconf: get configurable system 
.environ, .pref, 

unset: set and unset environment 
edit: text editor ( 

proc_ctl: control over 

/ns32000, pdp11, u3b, u3b2, u3b5, 


get option letter from argument 
readv: read 

writev: write 

assert: 

ve: 

get: geta 

scesdiff: compare two 

virtual memory efficient way 
output of a varargs/ vprintf, 
editor based on ex 

more: 
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-val: validate SCCS file 


....Uucheck(1M) 


uucp directories and permissions file. 


uucp file transport program....... uusched(1M) 
uucp: networking support files.......ssssessssssssscecseeseenes uucp(4) 
uucp spool directory clean-up... uucleanup(1M) 


uucp status inquiry and job contro! 
UUCP SYSTEM ......e0008: 
uucp, uulog, uuname: 
uugetty: set terminal type, modes... 
uulog, uuname: UNIX-to-UNIX/...... 
uuname: UNIX-to-UNIX system copy. 
uupick: public UNIX-to-UNIX/. 
uusched: the scheduler for the uucp 
uustat: uucp status inquiry and job. 


uuto, uupick: public... uuto(1C) 
Uutry: try to contact remote system. uutry(1M) 
UUX; UNIX-tO-UNIX....ccsessesesesesssserees: -uux(1C) 


uuxgqt(1M) 
+ al(1) 
veeVal(1) 
..valloc(3SEQ) 
-abs(3C) 
machid(1) 


uuxqt: execute remote command... 


validate SCCS file....... 
valloc: aligned memory allocator.. 
value 
value... 
value for environment name.. 
value functions. 
value of a symbolic li 
value to environment.. 
VAIUCS...ecsesecsssseesecesenes 
values... 
values.. 
values: machine-dependent values 
varargs argument list... 
varargs: handle variable argument... 
variable argument list.. 
variables.... 

variables. 
-variables: FACE files.. 
variables in core or in files 
variant of ex for casual] users) 


‘values(5) 
-values(5) 
..vprint{(3S) 


syscon{{(2) 


various process attributes....... 
vax: get processor type truth value 
Ve: Version CONtTO] .....csseseesee seavossunten 

getopt(3C) 
vector from file... -readv(2SEQ) 
vector on a file.... writev(2SEQ) 


verify program assertion «assert(3X) 


version Control... eee VO(1) 
version of an SCCS file.. ..get(1) 
versions of an SCCS file... seesdiff{1) 
vfork: spawn new process in a... vfork(2) 
vfprintf, vsprintf: print formatted... vprint{(3S) 
vi: screen-oriented (visual) display. we Vi(1) 
view a file one full screen at a time more(1) 
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@ map physical addresses into processs 
devtab: 

devdestroy: build and destroy 

vfork: spawn new process in a 
vm_ct]: examine and change 

echo: put string on 

controlling terminal fvhangup: 
vmtune: tune system-wide 

pmap: display or alter parameters of 
vi: screen-oriented 

memory tuning parameters 
virtual-memory parameters 
filesystem 

fs, inode: format of file system 
formatted output of a varargs/ 

the controlling FMLI object 

a varargs/ vprintf, vfprintf, 
prtvtoc: print the 

prtvtoc: print the 

mkvtoc: populate 

vtoc: 


s_wait_barrier: initialize barrier, 


wait, waitpid: 
sigsuspend: 
process to stop or terminate 


stop or terminate wait, 
ftw: 


whodo: 
who: 


vintune: tune system- 
addformopt: add a form/SELECT 
we: 

fgetc, getw: get character or 
fputc, putw: put character or 
spellhist: unmatched spelling 
ed: change 

chdir: change 

getewd: get pathname of current 
pwd: 

specific alarms and/or the 
interface 


lseek: move read/ 
tirdwr: Transport Interface read/ 
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virtual memory efficient way.. ag 
vm_ctl(2SEQ) 


virtual memory tuning parameters.. 

Wirtiia) Out pPU bas incssccascavsccecsossincssscusesseessensnetsscussséciedesd echo(1F) 
virtually hangup the specified. ..fvhangup(2SEQ) 
virtual-memory parameters... ..Vintune(1M) 


virtual-to-physical mapping devices 
visual display editor based ON €X.....ssecssserssaserecsseeescers vi(1) 
vm_ctl: examine and change virtual. 
vmtune: tune system-wide... 
volcopy: make literal copy o! 


vprintf, vfprintf, vsprintf: print.. 
vsig: synchronize a co-process with 


vsprintf: print formatted output of. vprintf{(3S) 
VTOC of a block device.......sssseseee prtvtoc(1M) 
VTOC of a standalone disk device... ..prtvtoc(8) 
VTOC on disks... mkvtoc(1M) 


VTOC partitioning driver. 
vtoc: VTOC partitioning driver 
wait at barrier. 
wait: await completion of process .. 
wait for a child process to stop or termina 
wait for a signal 
wait, waitpid: wait for a child. 
waitpid: wait for a child process to 
walk a file tree... 
wall: write to all users.. 
WC! WOT COUNL..sssesseseeees 
wd: SSM SCSI disk controller 
what: identify SCCS files.......... 
whatis: describe what a command is 
who is doing what....... 
who is on the system. 
who: who is on the system 
whodo: who is doing what.... 
wide virtual-memory parameters.. 
window option to a menu... 
WOT COUNL ..essesencoeen 


word on a stream 
words file... 
working directory. 
working directory 
working directory... 
working directory name. 
working indicator....... 
wp: SSM parallel line printe 
write file pointer 
write interface STREAMS module...........04. snscsausassaas tirdwr(7) 
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write: 
putpwent: 
putspent: 
wall: 
write: 
writev: 


open: open for reading or 
utmp, wtmp: utmp and 
utmp, 

accounting records fwtmp, 
and execute command 
multiplexor driver 

tape interface 

xt: 

xs: 

bessel: jO, j1, jn, 
bessel: j0, j1, jn, y0, 


compress, uncompress, 


for dual-channel disk controller 
getzdinfo, getzdinfobyname: get 
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write(2) 
write password file entry... putpwent(3C) 
write shadow password file entry... .. putspent(3X) 


WTite to Al] USCTS .......scccrsenssreccccecerserecosecnssensacesenssenences wall(1) 


write to another user... write(1) 
write vector on a file... writev(2SEQ) 
write: write on a file ..Write(2) 


write: write to another user .. 


wtmp: utmp and wtmp entry formats.. 
wtmpfix: manipulate connect.. 
xargs: construct argument list(s) 
xs: Xylogics 781 terminal.......0..+. 
xt: Xylogics 472 MULITBUS magnetic.. 
Xylogics 472 MULITBUS magnetic tape interface 
Xylogics 781 terminal multiplexor driver... 
y0, yl, yn: Bessel functions. 
yl, yn: Bessel functions.. 
yacc: yet another compiler-compiler. 
zcat: compress and expand data. 
zd: dual-channel disk controller. 
zdformat: standalone disk formatter. 
ZAinfo StrUCtUTC..crresereeerereeereerrererenerer 


..getzdinfo(3SEQ) 
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NAME 


m4 — macro processor 


SYNOPSIS 


m4 [ options ] [ files ] 


DESCRIPTION 


12/89 


The m4 command is a macro processor intended as a front end for Ratfor, C. 
and other languages. Each of the argument files is processed in order. If 
there are no files or if. filename is -, the standard input is read. The pro- 
cessed text is written on the standard output. 


The options and their effects are as follows: 


> 


-e Operate interactively. Interrupts are ignored and the output is 
unbuffered. 
-8 Enable line sync output for the C preprocessor (#line ...) 


-Bint Change the size of the push-back and argument collection buffers 
from the default of 4096. 


-Hint Change the size of the symbol table hash array from the default of 
199. The size should be prime. 


-Sint Change the size of the call stack from the default of 100 slots. Macros 
take three slots and non-macro arguments take one. 


-Tint Change the size of the token buffer from the default of 512 bytes. 


To be effective, these flags must appear before any -D or -U flags and before 
any filenames: 


-Dname[=val] 
Defines name to val or to null in val’s absence. 


-Uname 
Undefines name. 


Macro calls have this form: 
name(argl,arg2,..., argn) 


The ( must immediately follow the name of the macro. If the name of a 
defined macro is not followed by a (, it is deemed to be a call of that macro 
with no arguments. Potential macro names consist of alphabetic letters, 
digits, and underscore (_), where the first character is not a digit. 


Leading unquoted blanks, tabs, and newlines are ignored while collecting 
arguments. Left and right single quotes are used to quote strings. The value 
of a quoted string is the string stripped of the quotes. 


When a macro name is recognized, its arguments are collected by searching 
for a matching right parenthesis. If fewer arguments are supplied than are in 
the macro definition, the trailing arguments are taken to be null. Macro eval- 
uation proceeds normally during the collection of the arguments, and any 
commas or right parentheses which happen to turn up within the value of a 
nested cal] are as effective as those in the original input text. After argument 
collection, the value of the macro is pushed back onto the input stream and 
rescanned. 
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once this is done the original meaning is lost. Their values are null unless 
otherwise stated. 


define The second argument is installed as the value of the macro 
whose name is the first argument. Each occurrence of $n in the 
replacement text, where n is a digit, is replaced by the n-th 
argument. Argument 0 is the name of the macro; missing argu- 
ments are replaced by the null string; $# is replaced by the 
number of arguments; $* is replaced by a list of all the argu- 
ments separated by commas; $@ is like $*, but each argument is 
quoted (with the current quotes). 


m4 makes available the following built-in macros. They may be redefined, but 


undefine Removes the definition of the macro named in its argument. 

defn Returns the quoted definition of its argument(s). It is useful for 
renaming macros, especially built-ins. 

pushdef Like define, but saves any previous definition. 

popdef Removes current definition of its argument(s), exposing the pre- 
vious one, if any. 

ifdef If the first argument is defined, the value is the second argu- 


ment, otherwise the third. If there is no third argument, the 
value is null. The word unix is predefined on UNIX system ver- 
sions of m4. 


shift Returns all but its first argument. The other arguments are 
quoted and pushed back with commas in between. The quoting 
nullifies the effect of the extra scan that will subsequently be 
performed. 

changequote Change quote symbols to the first and second arguments. The 
symbols may be up to five characters long. Changequote with- 
out arguments restores the original values. 


changecom Change left and right comment markers from the default # and 
newline. With no arguments, the comment mechanism is effec- 
tively disabled. With one argument, the left marker becomes 
the argument and the right marker becomes newline. With two 
arguments, both markers are affected. Comment markers may 
be up to five characters long. 


divert m4 maintains 10 output streams, numbered 0-9. The final out- 
put is the concatenation of the streams in numerical order; ini- 
tially stream 0 is the current stream. The divert macro changes 
the current output stream to its (digit-string) argument. Out- 
put diverted to a stream other than 0 through 9 is discarded. 


undivert Causes immediate output of text from diversions named as 
arguments, or all diversions if no argument. Text may be 
undiverted into another diversion. Undiverting discards the 


diverted text. 

divnum Returns the value of the current output stream. 

dnl Reads and discards characters up to and including the next 
newline. 
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incr 


decr 


eval 


len 


index 


substr 


translit 
include 
sinclude 
sysemd 


sysval 


maketemp 
m4exit 
m4wrap 


errprint 
dumpdef 
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Has three or more arguments. If the first argument is the same 
string as the second, then the value is the third argument. If 
not, and if there are more than four arguments, the process is 
repeated with arguments 4, 5, 6 and 7. Otherwise, the value is 
either the fourth string or, if it is not present, null. 


Returns the value of its argument incremented by 1. The value 
of the argument is calculated by interpreting an initial digit- 
string as a decimal number. 


Returns the value of its argument decremented by 1. 


Evaluates its argument as an arithmetic expression, using 
32-bit arithmetic. Operators include +, -, *, /, %, * (exponentia- 
tion), bitwise &, |, *, and~;relationals; parentheses. Octal and 
hex numbers may be specified as in C. The second argument 
specifies the radix for the result; the default is 10. The third 
argument may be used to specify the minimum number of digits 
in the result. 


Returns the number of characters in its argument. 


Returns the position in its first argument where the second 
argument begins (zero origin), or —1 if the second argument does 
not occur. 


Returns a substring of its first argument. The second argument 
is a zero origin number selecting the first character; the third 
argument indicates the length of the substring. A missing third 
argument is taken to be large enough to extend to the end of the 
first string. 


Transliterates the characters in its first argument from the set 
given by the second argument to the set given by the third. No 
abbreviations are permitted. 


Returns the contents of the file named in the argument. 


Is identical to include, except that it says nothing if the file is 
inaccessible. 


Executes the operating system command given in the first argu- 
ment. No value is returned. 


The return code from the last call to sysemd. 


Fills in a string of XXXXX in its argument with the current pro- 
cess ID. 


Causes immediate exit from m4. Argument 1, if given, is the 
exit code; the default is 0. 


Argument 1 will be pushed back at final EOF; for example, 
m4wrap(cleanup()’) 


Prints its argument on the diagnostic output file. 


Prints current names and definitions for the named items or for 
all, if no arguments are given. 
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traceon With no arguments, turns on tracing for all macros (including 
built-ins). Otherwise, turns on tracing for named macros. a) 
traceoff Turns off trace globally and for any macros specified. Macros 
specifically traced by traceon can be untraced only by specific 
calls to traceoff. 
SEE ALSO 
ee(1), epp(1) 


4 12/89 


DYNIX/ptx MACHID(1) 


NAME 
&) machid: i386, ns32000, pdp11, u3b, u3b2, u3b5, vax — get processor type truth 
value 


SYNOPSIS 
i386 
ns32000 
pdpll 
u3b 
u3b2 
u3b5 
vax 


DESCRIPTION 
The following commands will return a true value (exit code of 0) if you are on 
the processor the command name indicates. 


i386 True if you are on an Intel 386-based computer. 
, ns32000 True if you are on a National 32000-based computer. 
pdpll True if you are on a PDP-11/45 or PDP-11/70. 
usb True if you are on a 3B20 computer. 
u3b2 True if you are on a 3B2 computer. 
= u3b5 True if you are on a 3B5 computer. 
vax True if you are on a VAX-11/750 or VAX-11/780. 


The commands that do not apply will return a false (non-zero) value. These 
commands are often used within makefiles (see make(1)) and shell procedures 
(see sh(1)) to increase portability. 

SEE ALSO 
make(1), sh(1), test(1), true(1) 
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NAME 

mail, rmail — send mail to users or read mail 
SYNOPSIS 

Sending mail: 


mail [ -wt ] persons 
rmail [ -wt ] persons 
Reading mail: 


mail [ -ehpqr ] [ -f file ] [ -F persons ] 


DESCRIPTION 


Sending mail: 
The following command-line arguments affect sending mail: 


-w Causes a letter to be sent to a remote user without waiting for the 
completion of the remote transfer program. 


-t Causes a To: line showing the intended recipients to be added to the 
letter. : 


A person is usually a user name recognized by login(1). When Persons are 
named, mail assumes a message is being sent (except in the case of the -F 
option). It reads from the standard input up to an end-of-file (Ctrl-D), or until 
it reads a line consisting of just a period. When either of those signals is 
received, mail adds the letter to the mailfile for each person. The mailfile of 
the person must be writeable by group ’mail’, or the letter will be undeliver- 
able. A letter is a message preceded by the sender’s name anda postmark. A 
postmark consists of one or more From lines followed by a blank line. 


If a letter is found to be undeliverable, it is returned to the sender with diag- 
nostics that indicate the location and nature of the failure. If mail is inter- 
rupted during input, the file dead. letter is saved to allow editing and resend- 
ing. dead.letter is recreated every time it is needed, erasing any previous con- 
tents. 


rmail permits only the sending of mail; uucp(1C) uses rmail as a security 
precaution. 

If the local system has the Basic Networking Utilities installed, mail may be 
sent to a recipient on a remote system. Prefix person by the system name and 
an exclamation point. A series of system names separated by exclamation 
points can be used to direct a letter through an extended network. 

Reading Mail: 


The following command-line arguments affect reading mail: 


-e Causes mail not to print. An exit value of 0 is returned if the 
user has mail. Otherwise, an exit value of 1 is returned. 

-h Causes a window of headers to be displayed rather than the 
latest message. The display is followed by the ? prompt. 

-p Causes all messages to print without prompting for disposition. 

-q Causes mail to terminate after interrupts. Normally an inter- 


rupt causes only the termination of the message being printed. 


MAIL(1) DYNIX/ptx 


-r Causes messages to be printed in first-in, first-out order. 
-ffile Causes mail to use file (for example, mbox) instead of the default & 
mailfile. 


-Fpersons Entered into an empty mailbox, causes all incoming mail to be 
forwarded to persons. 


mail, unless otherwise influenced by command-line arguments, prints a user’s 
mail messages in last-in, first-out order. For each message, the user is 
prompted with a ? and a line is read from the standard input. The following 
commands are available to determine the disposition of the message: 


<newline>, +, orn Go to the next message. 


d, or dp Delete message and go to the next message. 

d# Delete message number #. Do not go to the next message. 

dq Delete message and quit mail. 

h Display a window of headers around current message. 

h# Display header of message number #. 

ha Display headers of ALL messages in the user’s mailfile. 

hd Display headers of messages scheduled for deletion. 

p Reprint current message. 

- Print previous message. 

a Print message that arrived during the mail session. 

# Print message number #. 

r[users ] Reply to the sender and other user(s), then delete the mes- 
sage. 

s[ files ] Save message in the named files (mbox is default). 

y Same as save. 

ul #] Undelete message number # (default is last read). 

w[files ] Save message, without its top-most header, in the named 
files (mbox is default). 

m [persons ] Mail the message to the named persons. 

q, or Ctrl-D Put undeleted mail back in the mailfile and quit mail. 

x Put all mail back in the mailfile unchanged and exit mail. 

lcommand Escape to the shell to execute command. 

? Print a command summary. 


When a user logs in, the presence of mail (if any) is indicated. Also, notifica- 
tion is made if new mail arrives while using mail. 


The mailfile may be manipulated in two ways to alter the function of mail. 
The other permissions of the file may be read-write, read-only, or neither read 
nor write to allow different levels of privacy. If changed to other than the 
default, the file will be preserved even when empty to perpetuate the desired 
permissions. 
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The file can also contain this first line: 
Forward to person 


This line causes all mail sent to the owner of the mailfile to be forwarded to 
person. A Forwarded by... message is added to the header. This is espe- 
cially useful in a multi-machine environment to forward all of a person’s mail 
to a single machine and to keep the recipient informed if the mail has been 
forwarded. Installation and removal of forwarding is done with the -F option. 


To forward all of one’s mail to systema/user, enter this command: 
mail -Fsystema!user 

To forward to more than one user, enter this command: 
mail -F"userl,systema!user2,systema!systemb!user3" 


Note that when more than one user is specified, the whole list should be 
enclosed in double quotes so that it can be interpreted as the operand of the 
-F option. The list can be up to 1024 bytes; either commas or white space can 
be used to separate users. 


The following list of characters should not be used anywhere in the mail -F 
argument list or in the "Forward to” line: 


;&1°,<>*() <CR> 
To remove forwarding, enter this command: 
mail -F'" 


The pair of double quotes is mandatory to set a NULL argument for the -F 
option. 


For forwarding to work properly, the mailfile should have “mail” as the group 
ID and the group permission should be read-write. 


FILES 
/etc/passwd To identify sender and locate persons 
/usr/mail/user Incoming mail for user (the mailfile) 
$HOME/mbox Saved mail 
$MAIL Variable containing pathname of mailfile 
/tmp/ma* Temporary file 
/usr/mail/*.lock Lock for mail directory 
dead.letter Unmailable text 

SEE ALSO 


login(1), mailx(1), write(1) 


WARNING 


BUGS 


The “Forward to person” feature may result in a loop if sys1/userb forwards to 
sys2luserb and sys2!userb forwards to sys1/userb. The symptom is a message 
saying unbounded...saved mail in dead.letter 


Conditions sometimes result in a failure to remove a lock file. 


After an interrupt, the next message might not print; printing can be forced by 
typing a p. 
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NAME 


mailbug — submit a bug report or enhancement request 


SYNOPSIS 


mailbug 


DESCRIPTION 
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The mailbug utility allows users to submit machine-readable bug reports to a 
Sequent customer service representative. This service is useful only if the 
customer service representative supports this method of problem tracking. 
Check with your system administrator to ensure that the mailbug service is 
supported before submitting a bug report. 


mailbug prompts for the information needed to fill out the bug report. After 
the user has typed in all the required information, mailbug allows the user to 
inspect and edit the bug report before it is mailed, or to cancel the report com- 
pletely. Unless the report is canceled, mailbug sends a copy to the customer 
service representative and a copy to the user submitting the report. Refer to 
your system administration documentation for information on installing the 
mailbug service. 

mailbug asks for the following information: 


Your company or organization name, unless the file /usr/lib/ mail- 
bug_co_name exists. /usr/lib/mailbug_co_name is a text file that 
might look like this: 

Sequent Computer Systems, Inc 

Department: New Product Introduction 


Your full name and phone number, unless the file .mailbug exists in 
your home directory. .mailbug is a text file that might look like this: 
Anne Harris 
Phone Number: 123-4567 
A one-line summary of the bug. 
A full description of the bug, which may be as long as necessary. (See 
below for "“ commands which are available). 
Whether the problem happens on the system you are running mail- 
bug on. 
An assessment of the severity of the bug. The choices are: 
Critical — an essential component of the hardware or operat- 
ing system cannot be used. 
Serious — a non-essential module or utility cannot be used. 
Normal — some feature of a non-essential module or utility 
doesn’t work correctly, and there is no convenient workaround. 


Low — some feature of a non-essential module or utility 
doesn’t work correctly, but a user can work around the prob- 
lem without serious inconvenience. 

Enhancement — suggestions on how the product can be 
improved. 
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For Your Information — for information only, no action 
need be taken. 
A guess as to the source of the problem: documentation, hardware, 
mechanical, software, or other. 
For documentation problems, mailbug prompts for the name of the 
manual involved, the part number of the manual from the title page, 
and the page numbers. 
For hardware and mechanical bugs, mailbug prompts for the type of 
hardware component (e.g., MULTIBUS disk controller board, periph- 
eral mounting tower), and its part number, revision number, and 
serial number. 
For software bugs, mailbug prompts for the pathname of the file(s) 
that the user suspects are incorrect —e.g., /usr/ucb/man. 
Once the information is typed in, the user is given the opportunity to display 
the mailbug, edit it, abort (don’t send the mailbug), or submit the mailbug. 
If the requested information is unknown or is not applicable, some fields can 
be skipped by simply typing Return in response to the prompt. 
While the problem description is being typed in, certain operations can be per- 
formed on the input: 
If a line in the description is “v", then the user’s $EDITOR (or vi by 
default) is started to edit the description text typed in thus far. 
Ifa line in the description is of the form “*r filename", then the contents 
of filename are included in the text of the description. 


SEE ALSO 
uucp(1) 
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NAME 


mailx — interactive message processing system 


SYNOPSIS 


mailx [options] [name...] 


DESCRIPTION 


The command mailx provides a comfortable, flexible environment for sending 
and receiving messages electronically. When you are reading mail, mailx pro- 
vides commands to facilitate saving, deleting, and responding to messages. 
When you are sending mail, mailx allows editing, reviewing and other modifi- 
cation of the message as it is entered. 


For each user, incoming mail is stored in a standard file called the mailbox. 
When mailx is called to read messages, the mailbox is the default place to find 
them. As messages are read, they are marked to be moved to a secondary file 
for storage unless specific action is taken so that the messages need not be 
seen again. This secondary file is called the mbox and is normally located in 
the user’s home directory (see MBOX (Environment Variables) for a descrip- 
tion of this file). Messages can be saved in other secondary files named by the 
user. Messages remain in a secondary file until forcibly removed. 


The user can access a secondary file by using the -f option of the mailx com- 

mand. Messages in the secondary file can then be read or otherwise processed 

by using the same commands as in the primary mailbox. This gives rise 

within these pages to the notion of a current mailbox. 

On the command line, options start with a dash (-) and any other arguments 

are taken to be destinations (recipients). If no recipients are specified, mailx 

will attempt to read messages from the mailbox. Command line options are as 

follows: 

-e Test for presence of mail. mailx prints nothing and exits with 
a successful return code if there is mail to read. 


-f [filename] Read messages from filename instead of mailbox. If no 
filename is specified, the mbox is used. 

-F Record the message in a file named after the first recipient. 
Overrides the record variable, if set (see Environment Vari- 
ables). 

~h number —_ The number of network hops made s0 far. This is provided for 
network software to avoid infinite delivery loops. (See 
addsopt under Environment Variables). 


-H Print header summary only. 

-i Ignore interrupts. See also ignore (Environment Vari- 
ables). 

—n Do not initialize from the system default mailx.rc file. 

-N Do not print initial header summary. 


=r address Pass address to network delivery software. All tilde commands 
are disabled. (See addsopt under Environment Variables). 


—s subject Set the Subject header field to subject. 


MAILX(1) DYNIX/ptx 


-u user Read user’s mailbox. This is only effective if user’s mailbox is 
not read protected. All user’s mailbox must be readable by © 
group mail. 

-U Convert uuep style addresses to internet standards. Over- 


rides the conv environment variable. (See addsopt under 
Environment Variables) 


When you are reading mail, mailx is in command mode. A header summary 
of the first several messages is displayed, followed by a prompt indicating 
mailx can accept regular commands (see Commands below). When you are 
sending mail, mailx is in input mode. If no subject is specified on the com- 
mand line, a prompt for the subject is printed. (A subject longer than 1024 
characters will cause mailx to dump core). As the message is typed, mailx 
will read the message and store it in a temporary file. Commands may be 
entered by beginning a line with the tilde (~) escape character followed by a 
single command letter and optional arguments. See Tilde Escapes for a 
summary of these commands. 


At any time, the behavior of mailx is governed by a set of environment vari- 
ables. These are flags and valued parameters which are set and cleared via 
the set and unset commands. See Environment Variables below for a sum- 
mary of these parameters. 


Recipients listed on the command line may be of three types: login names, 
shell commands, or alias groups. Login names may be any network address, 
including mixed network addressing. If mail is found to to undeliverable, an 
attempt is made to return it to the sender’s mailbox. If the recipient name 
begins with a pipe symbol ( | ), the rest of the name is taken to be a shell com- 
mand to pipe the message through. This provides an automatic interface with 
any program that reads the standard input, such as Ip(1) for recording outgo- 
ing mail on paper. Alias groups are set by the alias command (see Com- 
mands below) and are lists of recipients of any type. 


Regular commands have the following form: 
[command ][ msglist ][ arguments ] 


If no command is specified in command mode, print is assumed. In input 
mode, commands are recognized by the escape character, and lines not treated 
as commands are taken as input for the message. 


Each message is assigned a sequential number. There is at any time the 
notion of a current message, marked by a right angle bracket (>) in the header 
summary. Many commands take an optional list of messages (msglist) to oper- 
ate on. The default for msglist is the current message. A msglist is a list of 
message identifiers, separated by spaces, that can include the following: 


n Message number n 

. The current message 

= The first undeleted message 
$ The last message 

: All messages _ 
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n-m An inclusive range of message numbers 

user All messages from user 

/string All messages with string in the subject line (case ignored) 
Fa) All messages of type c, where c is one of the following: 


d_ Deleted messages 
n New messages 

o Old messages 

r Read messages 

u__— Unread messages 


Note that the context of the command determines whether this type of 
message specification makes sense. 


Other arguments are usually arbitrary strings whose usage depends on the 
command involved. Filenames, where expected, are expanded via the normal 
shell conventions. Special characters are recognized by certain commands and 
are documented with the commands below. 


At start-up time, mailx tries to execute commands from the optional system- 
wide file (/usr/lib/ mailx/mailx.rc) to initialize certain parameters, then from 
a private start-up file ($HOME/.mailrc) for personalized variables. With the 
exceptions noted below, regular commands are legal inside start-up files. The 
most common use of a start-up file is to set up initial display options and alias 
lists. The following commands are not legal in the start-up file: !, Copy, edit, 
followup, Followup, hold, mail, preserve, reply, Reply, shell, and visual. An 
error in the start-up file causes the remaining lines in the file to be ignored. 
The .maiirc file is optional, and must be constructed locally. 


Commands 


The following is a complete list of mailx commands: 


\shell-command 
Escape to the shell. See SHELL (Environment Variables). 


comment 
Null command (comment). This may be useful in .mailrc files. 


= Print the current message number. 
? Print a summary of commands. 


alias alias name... 

group alias name... 
Declare an alias for the given names. The names will be substituted 
when alias is used as a recipient. Useful in the .mailrc file. 


alternates name... 
Declares a list of alternate names for your login. When responding to 
a message, these names are removed from the list of recipients for the 
response. With no arguments, alternates prints the current list of 
alternate names. See also allnet (Environment Variables). 


ed [directory] 


cehdir [directory] 
Change directory. If directory is not specified, $HOME is used. 
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copy [filename] 

copy [msglist] filename 
Copy messages to the file without marking the messages as saved. 
Otherwise equivalent to the save command. 


Copy [msglist] 
Save the specified messages in a file whose name is derived from the 
author of the message to be saved, without marking the messages as 
saved. Otherwise equivalent to the Save command. 


delete [msglist] 
Delete messages from the mailbox. If autoprint is set, the message 
following the last deleted message prints (see Environment Vari- 
ables). 


discard (header-field ...] 

ignore [header-field ...] 
Suppresses printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are status 
andcc. The fields are included when the message is saved. The Print 
and Type commands override this command. 


dp [msglist] 

dt [msglist] 
Delete the specified messages from the mailbox and print the message 
following the last deleted message. Roughly equivalent to a delete 
command followed by a print command. 


echo string ... 
Echo the given strings (like echo(1)). 


edit [msglist] 
Edit the given messages. The messages are placed in a temporary file 
and the EDITOR variable is used to get the name of the editor (see 
Environment Variables). Default editor is ed(1). 

exit 

xit Exit from mailx without changing the mailbox. No messages are 
saved in the mbox (see also quit). 


file [filename] 
folder [filename] 
Quit from the current file of messages and read in the specified file. 
Several special characters are recognized when used as filenames with 
the following substitutions: 
% The current mailbox 
%user The mailbox for user 
# The previous file 
& The current mbox 
Default file is the current mailbox. 


folders 
Print the names of the files in the directory set by the folder variable 
(see Environment Variables). 


followup [message] 
Respond to a message, recording the response in a file whose name is 
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derived from the author of the message. Overrides the record vari- 
able, if set. See also the Followup, Save, and Copy commands and 
outfolder (Environment Variables). 


Followup [msglist] 
Respond to the first message in the msglist, sending the message to 
the author of each message in the maglist. The subject line is taken 
from the first message and the response is recorded in a file whose 
name is derived from the author of the first message. See also the fol- 
lowup, Save, and Copy commands and outfolder (Environment 
Variables). 


from [msglist] 
Prints the header summary for the specified messages. 


group alias name... 
alias alias name... 
Declare an alias for the given names. The names will be substituted 


when alias is used as a recipient. Useful in the .mailrc file. 


headers [message] . 
Prints the page of headers which includes the message specified. The 
screen variable sets the number of headers per page (see Environ- 
ment Variables). See also the z command. 


help Prints a summary of commands. 


hold [msglist] 
preserve [msglist] 
Holds the specified messages in the mailbox. 


ifs |r 
mail-commands 
else 
mail-commands 


endif 


Conditional execution, where s will execute following mail-commands, 
up to an else or endif, if the program is in send mode, and r causes the 
mail-commands to be executed only in receive mode. Useful in the 


-mailrc file. 


ignore header-field ... 

discard header-field ... 
Suppresses printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are status 
andcc. All fields are included when the message is saved. The Print 


and Type commands override this command. 
list Prints all commands available. No explanation is given. 


mail name ... 
Mail a message to the specified users. 


Mail name 
Mail a message to the specified user and record a copy of it in a file 


named after that user. 
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mbox [msglist] 
Arrange for the given messages to end up in the standard mbox save & 
file when mailx terminates normally. See MBOX (Environment 
Variables) for a description of this file. See also the exit and quit 
commands. 


next [message] 
Go to next message matching message. A msglist may be specified, but 
in this case the first valid message in the list is the only one used. 
This is useful for jumping to the next message from a specific user, 
since the name would be taken as a command in the absence of a real 
command. See the discussion of msglists above for a description of pos- 
sible message specifications. 


pipe [msglist] [shell-command] 

| "" [msglist] [shell-command] 
Pipe the message through the given shell-command. The message is 
treated as if it were read. If no arguments are given, the current mes- 
sage is piped through the command specified by the value of the cmd 
variable. If the page variable is set, a form feed character is inserted 
after each message (see Environment Variables). 


preserve [msglist] 
hold [msglist] 

Preserve the specified messages in the mailbox. 
Print [msglist] 


Type [msglist] 
Print the specified messages on the screen, including all header fields. 


Overrides suppression of fields by the ignore command. 


print [msglist] 

type [msglist] 
Print the specified messages. If crt is set, the messages longer than 
the number of lines specified by the ert variable are paged through 
the command specified by the PAGER variable. The default command 
is pg(1) (see Environment Variables). 


quit Exit from mailx, storing messages that were read in mbox and unread 
messages in the mailbox. Messages that have been explicitly saved in 
a file are deleted. 


Reply [msglist] 

Respond [msglist] 
Send a response to the author of each message in the msglist. The 
subject line is taken from the first message. If record is set toa 
filename, the response is saved at the end of that file (see Environ- 
ment Variables). 


reply [message] 

respond [message] 
Reply to the specified message, including all other recipients of the 
message. If record is set to a filename, the response is saved at the 
end of that file (see Environment Variables). 
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Save [msglist] 
Save the specified messages in a file whose name is derived from the 
author of the first message. The name of the file is the author’s name 
with all network addressing stripped off. See the Copy, followup, and 
Followup commands and outfolder (Environment Variables). 


save [filename] 

save [msglist] filename 
Save the specified messages in the given file. The file is created if it 
does not exist. The message is deleted from the mailbox when mailx 
terminates unless keepsave is set (see also Environment Variables 
and the exit and quit commands). 


set 

set name 

set name=string 

set name=number 
Define a variable called name. The variable may be given a null, 
string, or numeric value. set by itself prints all defined variables and 
their values. See Environment Variables for detailed descriptions 
of the mailx variables. 


shell Invoke an interactive shell (see SHELL (Environment Variables)). 


size [msglist] 
Print the size in characters of the specified messages. 


source filename 
Read commands from the given file and return to command mode. 
top [msglist] 
Print the top few lines of the specified messages. If the toplines vari- 
able is set, it is taken as the number of lines to print (see Environ- 
ment Variables). The default is 5. 


touch [msglist] 
Touch the specified messages. If any message in msglist is not specifi- 
cally saved in a file, it will be placed in the mbox (or the file specified 
in the MBOX environment variable) upon normal termination. See 
exit and quit. 


Type [msglist] 

Print [maglist] 
Print the specified messages on the screen, including all header fields. 
Overrides suppression of fields by the ignore command. 


type [maglist] 

print [msglist] 
Print the specified messages. If ert is set, the messages longer than 
the number of lines specified by the ert variable are paged through 
the command specified by the PAGER variable. The default command 
is pg(1) (see Environment Variables). 


undelete [msglist] 
Restore the specified deleted messages. Will only restore messages 
deleted in the current mail session. If autoprint is set, the last mes- 
sage of those restored is printed (see Environment Variables). 
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unset name... 
Causes the specified variables to be erased. If the variable was 
imported from the execution environment (i.e., a shell variable) then it 
cannot be erased. 


version 
Prints the current version and release date. 


visual [meglist] 
Edit the given messages with a screen editor. The messages are 
placed in a temporary file and the VISUAL variable is used to get the 
name of the editor (see Environment Variables). 


write [msglist] filename 
Write the given messages on the specified file, minus the header and 
trailing blank line. Otherwise equivalent to the save command. 

xit 

exit Exit from mailx without changing the mailbox. No messages are 
saved in the mbox (see also quit). 


2+! -] 
Scroll the header display forward or backward one screen. The num- 
ber of headers displayed is set by the screen variable (see Environ- 
ment Variables). 


Tilde Escapes 
The following commands can be entered only from input mode. You must 
begin the line with the tilde escape character (~). See escape (Environment 
Variables) for directions on changing this special character. 


“1 shell-command 
Escape to the shell. 
% Simulate end of file (terminate message input). 


“: mail-command 

~_ mail-command 
Perform the command-level request. Valid only when sending a mes- 
sage while reading mail. 

ts Print a summary of tilde escapes. 


“A Insert the autograph string Sign into the message (see Environment 
Variables). 


‘a Insert the autograph string sign into the message (see Environment 
Variables). 


Add the names to the blind carbon copy (Bec) list. 

“ce name... 
Add the names to the carbon copy (Cc) list. 

“d Read in the dead.letter file. See DEAD (Environment Variables) for 
a description of this file. 


“e Invoke the editor on the partial message. See also EDITOR (Environ- 
ment Variables). 
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“f [msglist] 
Forward the specified messages. The messages are inserted into the 
message without alteration. 
“h Prompt for Subject line and To, Cc, and Bcc lists. If the field has an 
initial value, it can be edited as if you just typed it. 
“i string 
Insert the value of the named variable into the text of the message. 
For example, “A is equivalent to “i Sign. Environment variables set 
and exported in the shell are also accessible by “i. 
“m([msglist] 
Insert the specified messages into the letter, shifting the new text to 
the right one tab stop. Valid only when sending a message while read- 
ing mail. 
‘Pp Print the message being entered. 


q Quit from input mode by simulating an interrupt. If the body of the 
message is not null, the partial message is saved in dead.letter. See 
DEAD (Environment Variables) for a description of this file. 
“x filename 
““« filename ‘ 
““< Ishell-command 
Read in the specified file. If the argument begins with an exclamation 
point (!), the rest of the string is taken as an arbitrary shell command 
and is executed, with the standard output inserted into the message. 
“g string ... 
Set the subject line to string. 
“t name... 
Add the given names to the To list. 
v Invoke a preferred screen editor on the partial message. See also 
VISUAL (Environment Variables). 
“w filename 
Write the partial message onto the given file, without the header. 
“x Exit as with “q except the message is not saved in dead.letter. 
“| shell-command 
Pipe the body of the message through the given shell-command. If the 
shell-command returns a successful exit status, the output of the com- 
mand replaces the message. 
Environment Variables 
The following environment variables are taken from the execution environ- 
ment and are not alterable within mailx. * 
HOME=directory 
The user’s base of operations. 
MAILRC=filename 
The name of the start-up file. Default is $HOME/.mailrc. 
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The following variables are internal mailx variables. They may be imported 
from the execution environment or set via the set command at any time. The 
unset command may be used to erase variables. 


addsopt Enabled by default. If /bin/mail is not being used as the deliverer, 
noaddsopt should be specified. (See WARNINGS below.) 


allnet —_All network names whose last component (login name) match are 
treated as identical. This causes the msglist message specifications 
to behave similarly. Default is noallnet. See also the alternates 
command and the metoo variable. 


append Upon termination, append messages to the end of the mbox file 
instead of prepending them. Default is noappend. 


askcc Prompt for the Cc list after message is entered. Default is 
noaskcc. 


asksub Prompt for subject if it is not specified on the command line with 
the -s option. Enabled by default. 

autoprint : 

Enable automatic printing of messages after delete and undelete 

commands. Default is noautoprint. 


bang Enable the special-casing of exclamation points (!) in shell escape 
command lines as in vi(1). Default is nobang. 


emd=shell-command 
Set the default command for the pipe command. No default value. 


conv=conversion 
Convert uucp addresses to the specified address style. The only 
valid conversion now is internet, which requires a mail delivery 
program conforming to the RFC822 standard for electronic mail 
addressing. Conversion is disabled by default. See also sendmail 
and the -U command line option. 


ert=number 
Pipe messages having more than number lines through the com- 
mand specified by the value of the PAGER variable (pg(1) by 
default). Disabled by default. 


DEAD=filename 
The name of the file in which to save partial letters in case of 
untimely interrupt. Default is $HOME/dead. letter. 


debug Enable verbose diagnostics for debugging. Messages are not 
delivered. Default is nodebug. 


dot - Take a period on a line by itself during input from a terminal as 
end-of-file. Default is nodot. 

EDITOR=shell-command 
The command to run when the edit or ~“e command is used. Default 
is ed(1). 

escape=c Substitute c for the ~ escape character. Takes effect with next mes- 
sage sent. 
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folder=directory 
The directory for saving standard mail files. User-specified 
filenames beginning with a plus (+) are expanded by preceding the 
filename with this directory name to obtain the real filename. If 
directory does not start with a slash (/), $HOME is prepended to it. 
In order to use the plus (+) construct on a mailx command line, 
folder must be an exported sh environment variable. There is no 
default for the folder variable. See also outfolder below. 


header Enable printing of the header summary when entering mailx. 
Enabled by default. 


hold Preserve all messages that are read in the mailbox instead of put- 
ting them in the standard mbox save file. Default is nohold. 


ignore Ignore interrupts while entering messages. Handy for noisy 
dial-up lines. Default is noignore. 


ignoreeof 
Ignore end-of-file during message input. Input must be terminated 
by a period (.) on a line by itself or by the ~. command. Default is 
noignoreeof. See also dot above. 


keep When the mailbox is empty, truncate it to zero length instead of 
removing it. Disabled by default. 


keepsave 
Keep messages that have been saved in other files in the mailbox 
instead of deleting them. Default is nokeepsave. 


MBOX=filename 
The name of the file used to save messages that have been read. 
The xit command overrides this function, as does saving the mes- 
sage explicitly in another file. Default is SHOME/ mbox. 


metoo If your login appears as a recipient, do not delete it from the list. 
Default is nometoo. 


LISTER=shell-command 
The command (and options) to use when listing the contents of the 
folder directory. The default is Is(1). 


onehop When responding to a message that was originally sent to several 
: recipients, the other recipient addresses are normally forced to be 

relative to the originating author’s machine for the response. This 
flag disables alteration of the recipients’ addresses, improving effi- 
ciency in a network where all machines can send directly to all 
other machines (that is, one hop away). 

outfolder 
Causes the files used to record outgoing messages to be located in 
the directory specified by the folder variable unless the pathname 
js absolute. Default is nooutfolder. See folder above and the 
Save, Copy, followup, and Followup commands. 


page Used with the pipe command to insert a form feed after each mes- 
sage sent through the pipe. Default is nopage. 
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FILES 


PAGER=shell-command 
The command to use as a filter for paginating output. This can also 
be used to specify the options to be used. Default is pg(1). 
prompt=string 
Set the command mode prompt to string. Default is “?” . 
quiet Refrain from printing the opening message and version when 
entering mailx. Default is noquiet. 
record=filename 
Record all outgoing mail in filename. Disabled by default. See also 
outfolder above. 


save Enable saving of messages in dead.letter on interrupt or delivery 
error. See DEAD for a description of this file. Enabled by default. 


screen=number 
Sets the number of lines in a screen of headers for the headers com- 


mand. 
sendmail=shell-command . 
Alternate command for delivering messages. Default is 
/bin/rmaiK1). 
sendwait Wait for background mailer to finish before returning. Default is 
nosendwait. 
SHELL=shell-command 
The name of a preferred command interpreter. Default is sh(1). 
showto When displaying the header summary and the message is from you, 
print the recipient’s name instead of the author’s name. 
sign=string 
The variable inserted into the text of a message when the “a (auto- 
graph) command is given. There is no default value. (See “i (Tilde 
Escapes)). 
Sign=string 
The variable inserted into the text of a message when the “A com- 
mand is given. There is no default. (See “i (Tilde Escapes)). 
toplines=number 
The number of lines of header to print with the top command. 
Default is 5. 


VISUAL=shell-command 
The name of a preferred screen editor. Default is vi(1). 


$HOME/.mailre Personal start-up file 
$HOME/mbox Secondary storage file 
/usr/mail/* Post office directory 
/usr/lib/mailx/mailx.help* Help message files 
fusr/ib/mailx/mailx.re Optional global start-up file 
/tmp/R[emqsx]* Temporary files 


SEE ALSO 
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WABNINGS 


BUGS 


The -h, -r and -U options can be used only if mailx is built with a delivery 
program other than /bin/mail. 


Where shell-command is shown as valid, arguments are not always allowed. 
Experimentation is recommended. 


Internal variables imported from the execution environment cannot be unset. 


The full internet addressing is not fully supported by mailx. The new stan- 
dards need some time to settle down. 


Attempts to send a message having a line consisting only of a “.” are treated 
as the end of the message by mail(1) (the standard mail delivery program). 


13 


DYNIX/ptx 


NAME 


MAKE(1) 


make — maintain, update, and regenerate groups of programs 


SYNOPSIS 


make [-f makefile] [-Pn] [-p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] [+t] [-q] 


[names] 
DESCRIPTION 


The make command allows the programmer to maintain, update, and regen- 
erate groups of computer programs. The following is a brief description of all 
options and some special names: 


-f makefile 


-p 


-Pn 


-i 


-k 


-r 


-DEFAULT 


-PRECIOUS 


«SILENT 
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Description filename. makefile is assumed to be the name of a 
description file. 


Print out the complete set of macro definitions and target 
descriptions. 


Permit n command sequences to be done in parallel with ‘&’. 
See Parallel Support section below. If this option is present 
multiple times on the command line, the least value for n 
supercedes the others. If this option is missing, make looks for 
the environment variable PARALLEL and uses its numeric 
value for n. If PARALLEL is undefined, n defaults to 3. 


Ignore error codes returned by invoked commands. This mode 
is entered if the fake target name IGNORE appears in the 
description file. 


Abandon work on the current entry if it fails, but continue on 
other branches that do not depend on that entry. 


Silent mode. Do not print command lines before executing. 
This mode is also entered if the fake target name .SILENT 
appears in the description file. ‘ 


Do not use the built-in rules. 


No execute mode. Print commands, but do not execute them. 
Even lines beginning with an at sign (@) are printed. 


Compatibility mode for old makefiles. 
Environment variables override assignments within makefiles. 


Touch the target files (causing them to be up-to-date) rather 
than issue the usual commands. 

Question. The make command returns a zero or non-zero sta- 
tus code depending on whether the target file is or is not 
up-to-date. 

If a file must be made but there are no explicit commands or 
relevant built-in rules, the commands associated with the 
name .DEFAULT are used if it exists. 

Dependents of this target are not removed when quit or inter- 
rupt are hit. 


Same effect as the —s option. 
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make executes commands in makefile to update one or more target names. 
name is typically a program. If no -f option is present, makefile, Makefile, and 
the Source Code Control System (SCCS) files s.makefile, and s.Makefile are 
tried in order. If makefile is -, the standard input is taken. More than one -f 
makefile argument pair may appear. 


make updates a target only if its dependents are newer than the target. All 
prerequisite files of a target are added recursively to the list of targets. Miss- 
ing files are deemed to be out-of-date. 


makefile contains a sequence of entries that specify dependencies. The first 
line of an entry is a blank-separated, non-null list of targets, then a:, then a 
(possibly null) list of prerequisite files or dependencies. Text following a ; and 
all following lines that begin with a tab are shell commands to be executed to 
update the target. The first non-empty line that does not begin with a tab or # 
begins a new dependency or macro definition. Shell commands may be con- 
tinued across lines with the <backslash><new-line> sequence. Everything 
printed by make (except the initial tab) is passed directly to the shell as is. 
Thus, 


IGNORE Same effect as the -i option. & 


echo a\ 
b 


will produce 


ab 
exactly the same as the shell would. @ 
Sharp (#) and new-line surround comments. 


The following makefile says that pgm depends on two files a.o and b.o, and 
that they in turn depend on their corresponding source files (a.c and b.c) anda 
common file incl.h: 


pgm: a.ob.o 

cc a.o b.o -o pgm 
a.o: incl.ha.c 

cc -c a.c 
b.o: incl.hb.c 

ce =-c bic 


Command ines are executed one at a time, each by its own shell. The SHELL 
environment variable can be used to specify which shell make should use to 
execute commands. The default is /bin/sh. The first one or two characters in 
a command can be the following: -, @, -@, or @-. If @ is present, printing of 
the command is suppressed. If -is present, make ignores an error. A line is 
printed when it is executed unless the ~s option is present, or the entry 
-SILENT: is in makefile, or unless the initial character sequence contains a @. 
The -n option specifies printing without execution; however, if the command 
line has the string $(MAKE) in it, the line is always executed (see discussion of 
the MAKEFLAGS macro under Environment). The -t (touch) option updates 
the modified date of a file without executing any commands. & 


Commands returning non-zero status normally terminate make. If the -i 
option is present, or the entry IGNORE: appears in makefile, or the initial 
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character sequence of the command contains -, the error is ignored. If the -k 
option is present, work is abandoned on the current entry, but continues on 
other branches that do not depend on that entry. 


The -b option allows old makefiles (those written for the old version of make) 
to run without errors. 


Interrupt and quit cause the target to be deleted unless the target is a depen- 
dent of the special name -PRECIOUS. 


Environment 


The environment is read by make. All variables are assumed to be macro def- 
initions and processed as such. The environment variables are processed 
before any makefile and after the internal rules. Thus, macro assignments in 
a makefile override environment variables. The -e option causes the environ- 
ment to override the macro assignments in a makefile. Suffixes and their 
associated rules in the makefile override any identical suffixes in the built-in 
rules. 


The MAKEFLAGS environment variable is processed by make as containing 
any legal input option (except -f and -p) defined for the-command line. Fur- 
ther, upon invocation, make invents the variable if it is not in the environ- 
ment, puts the current options into it, and passes it on to invocations of com- 
mands. Thus, MAKEFLAGS always contains the current input options. This 
proves very useful for super-makes. In fact, as noted above, when the -n 
option is used, the command $(MAKE) is executed anyway; hence, one can per- 
form a make —n recursively on a whole software system to see what would 
have been executed. This is because the -n is put in MAKEFLAGS and passed 
to further invocations of $(MAKE). This is one way of debugging all of the 
makefiles for a software project without actually doing anything. 


Include Files 


If the string include appears as the first seven letters of a line in a makefile 
and is followed by a blank or a tab, the rest of the line is assumed to be a 
filename and will be read by the current invocation, after substituting for any 
macros. 


Macros 


Entries of the form string! = string2 are macro definitions. String2 is defined 
as al] characters up to a comment character or an unescaped new-line. Subse- 
quent appearances of $(string1(:subst 1 =[subst2]]) are replaced by string2. 
The parentheses are optional if a single character macro name is used and 
there is no substitute sequence. The optional :subst] =subst2 is a substitute 
sequence. If it is specified, all non-overlapping occurrences of subst] in the 
named macro are replaced by subst2. Strings (for the purposes of this type of 
substitution) are delimited by blanks, tabs, new-line characters, and begin- 
nings of lines. An example of the use of the substitute sequence is shown 
under Libraries. 


Internal Macros 


There are five internally maintained macros that are useful for writing rules 
for building targets. 


$* The macro $* stands for the filename part of the current dependent with 
the suffix deleted. It is evaluated only for inference rules. 


MAKE(1) DYNIX/ptx 


evaluated only for explicitly named dependencies. 


$< The $< macro is only evaluated for inference rules or the .DEFAULT 
tule. It is the module that is out-of-date with respect to the target (i.e., 
the manufactured dependent filename). Thus, in the .c.o rule, the $< 
macro would evaluate to the .c file. 


$@ The $@ macro stands for the full target name of the current target. It is ‘ 


An example for making optimized.o files from .c files is as follows: 


GOs 
cc =-c -0 $¥.ic 


or: 


ce -c ~-O $< 


$2? The $? macro is evaluated when explicit rules from the makefile are 
evaluated. It is the list of prerequisites that are out-of-date with respect 
to the target; essentially, those modules which must be rebuilt. 


$% The $% macro is only evaluated when the target is an archive library 
member of the form lib(file.o). In this case, $@ evaluates to lib and $% 
evaluates to the library member, file.o. 


Four of the five macros can have alternative forms. When an uppercase D or 
F is appended to any of the four macros, the meaning is changed to “directory 
part” for D and “file part” for F. Thus, $(@D) refers to the directory part of 
the string $@. If there is no directory part, /is generated. The only macro 
excluded from this alternative form is $?. 


Suffixes 
Certain names (for instance, those ending with .o) have inferable prerequisites 
such as.c,.s, etc. Ifno update commands for such a file appear in makefile, 
and if an inferable prerequisite exists, that prerequisite is compiled to make 
the target. In this case, make has inference rules which allow building files 
from other files by examining the suffixes and determining an appropriate 
inference rule to use. The current default inference rules are as follows: 


.c .c° f .& .sh .sh” 

€.0 .C.A .C.0 .C.C .C.a 

fo fa f.0 ff fia 

-h’.h .s.0 .s”.0 .s”.s .s”.a .sh.sh 

d.o Le 1.0 1°] Ic 

-Y-0 -Y.c -y.0 -y.y yc 
The internal rules for make are contained in the source file rules.c for the 
make program. These rules can be locally modified. To print out the rules 
compiled into the make on any machine in a form suitable for recompilation, 
the following command is used: 


make -fp - 2>/dev/null </dev/null 


A tilde in the above rules refers to an SCCS file [see secsfile(4)]. Thus, the 
Tule .c”.o would transform an SCCS C source file into an object file (.0). 
Because the s. of the SCCS files is a prefix, it is incompatible with make’s suf- 
fix point of view. Hence, the tilde is a way of changing any file reference into 
an SCCS file reference. 
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Arule with only one suffix (i.e., .c:) is the definition of how to build x from x.c. 
In effect, the other suffix is null. This is useful for building targets from only 
one source file (e.g., shell procedures, simple C programs). 

Additional suffixes are given as the dependency list for SUFFIXES. Order is 
significant; the first possible name for which both a file and a rule exist is 
inferred as a prerequisite. The default list is: 

-SUFFIXES: .0 .c .c” cy -y~ 1 I” .s .s” .sh sh” -h ch f ff 


Here again, the above command for printing the internal rules will display the 
list of suffixes implemented on the current machine. Multiple suffix lists accu- 
mulate; .SUFFIXES: with no dependencies clears the list of suffixes. 


Inference Rules 


The first example can be done more briefly. 


pgm: a.ob.o 
cc a.o b.o -O pgm 
a.ob.o: incl.h 


This is because make has a set of internal rules for building files. The user 
may add rules to this list by simply putting them in the makefile. 


Certain macros are used by the default inference rules to permit the inclusion 
of optional matter in any resulting commands. For example, CFLAGS, 
LFLAGS, and YFLAGS are used for compiler options to ece(1), lex(1), and 
yace(1), respectively. Again, the previous method for examining the current 
rules is recommended. 


The inference of prerequisites can be controlled. The rule to create a file with 
suffix .o from a file with suffix .c is specified as an entry with .c.o: as the target 
and no dependents. Shell commands associated with the target define the rule 
for making a.o file from a.c file. Any target that has no slashes in it and 
starts with a dot is identified as a rule and not a true target. 


Libraries 
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If a target or dependency name contains parentheses, it is assumed to be an 
archive library, the string within parentheses referring to a member within 
the library. Thus lib/(file.o) and $(LIB)(file.o) both refer to an archive library 
that contains file.o. (This assumes the LIB macro has been previously 
defined.) The expression $(LIB)(file1.0 file2.0) is not legal. Rules pertaining to 
archive libraries have the form XX.a where the XX is the suffix from which 
the archive member is to be made. An unfortunate byproduct of the current 
implementation requires the XX to be different from the suffix of the archive 
member. Thus, one cannot have lib(file.o) depend upon file.o explicitly. The 
most common use of the archive interface follows. Here, we assume the source 
files are all C type source: 
lib: lib(filel.o) lib(file2.0) lib(file3.o) 
@echo lib is now up-to-date 
.C.a: 
$(cc) -c S$(CFLAGS) S< 
S(AR) S(ARFLAGS) $@ S*.o 
rm -f $S*.0 
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In fact, the .c.a rule listed above is built into make and is unnecessary in this example. e 


Amore interesting, but more limited example of an archive library mainte- 
nance construction follows: 


lib: lib(filel.o) lib(file2.0) lib(file3.o) 
$(cc) -c S(CFLAGS) $(?:.0=.c) 
$(AR) S(ARFLAGS) lib $? 
rm $? @echo lib is now up-to-date 
-C.arz 


Here the substitution mode of the macro expansions is used. The $? list is 
defined to be the set of object filenames (inside Jib) whose C source files are 
out-of-date. The substitution mode translates the .o to.c. (Unfortunately, one 
cannot as yet transform to .c™; however, this may become possible in the 
future.) Note also, the disabling of the .c.a: rule, which would have created 
each object file, one by one. This particular construct speeds up archive 
library maintenance considerably. This type of construct becomes very cum- 
bersome if the archive library contains a mix of assembly programs and C pro- 
grams. 


Parallel Support 
make includes a parallel processing ability. If the string separating a target 
from its prerequisites is :&, :$&, ::&, or ::$&, make can run the command 
sequences to make the prerequisites simultaneously. If two names are 
separated by an ampersand (& or $&) on the right side of a colon, those two 
may be created in parallel. 


In this example makefile, if the objects a.o, b.o, andc.o are out of date, they are 
built in parallel: 


pgm: Sé& a.o b.o c.0 
cc -O pgm a.o b.o c.o 
a.o a.c defs.h 
b.o: b.c defs.h 
c.o c.c defs.h 


In this example, only a.o and b.o are built in parallel, with c.o being started 
after the other two complete: 


pgm: a.o S& b.o c.o 
cc -O pgm a.o b.o c.o 


a.o a.c defs.h 
b.o b.c defs.h 
c.o c.c defs.h 


Since the -P option is not compatible with other versions of make, the use of 
$& is preferred over &. This is because $& is a macro which is replaced by &, 
but in other versions of make it has no effect. Thus, the same makefile can be 
used on other systems. Another way to avoid problems is by creating a shell 
script called make, and placing it in /usr/local: 


#!/bin/sh 
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if [ S$# !=0 ] 
then 
exec /bin/make P='&' "S@" 
else 
exec /bin/make P=’&' 
fi 


and changing your targets from their present construct: 
FILES : headers.o main.o 
to a portable form: 
FILES :$(P) headers.o main.o 
If you use either technique, make is portable between systems. The —P option 
controls the number of simultaneous command streams. make invoked with 


an argument of -P1 selects no parallelism, and is useful when error messages 
from parallel command sequences are intermingled, obscuring the actual 


. Source of error. (A useful technique for searching the output for error mes- 


sages is to look for lines that do not begin with a tab character.) 


To execute command sequences in parallel, make forks off processes without 
waiting for them, and indicates they’ve been forked by appending an amper- 
sand and the process ID while printing the command (similar to using the 
ampersand to indicate asynchronous jobs in the shell). If the forked-off com- 
mand sequence returns a non-zero exit status, make precedes the error (or 
warning) message with the process ID, to help determine the source of the 
error. 


Not all command sequences can be made parallel. Some command sequences 
generate filenames in the current directory that do not depend on the file 
being built. For example, operations involving two or more usages of yacc, 
lex, ar, or xstr in the same directory cannot be made parallel. 


While building the prerequisites in parallel, only the last (or only) command 
in a multiple command sequence is eligible to be forked for asynchronous exe- 
cution. Other commands are executed sequentially. For example, in the fol- 
lowing makefile, only lastcommand is run in parallel; firstcommand and 
secondcommand are processed before any of the commands to build b are 
invoked: 


pgm:S& ab 

a: 
firstcommand 
secondcommand 
lastcommand 

b: 


b-firstcommand 
b-secondcommand 
b-lastcommand 


To circumvent this, make all the commands be considered as one long shell 
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command, as in: 


pgm:$& a b 

a: 

firstcommand; \ 
secondcommand; \ 
lastcommand 


b-firstcommand; \ 
b-secondcommand; \ 
b-lastcommand 


The backslash at the end of a command line causes the following line to be 
regarded as a continuation. A makefile set up in this way has all the com- 
mands to build a be run in parallel with all the commands to build 6. Note 
that all three commands to build a are now executed by the same shell (rather 
than three separate invocations of the shell). Commands interpreted by the 
shell directly (to change directory, for example) are no longer isolated to one 
particular command line. This should be taken into consideration when alter- 
ing the makefiles in this way. 


FILES 
[(Mm]Jakefile and s.[Mm]akefile 


/oin/sh 


SEE ALSO 
cce(1), ed(1), lex(1), sh(1), yacc(1), printf(3S), scesfile(4) 

NOTES 
Some commands return non-zero status inappropriately; use -i to overcome 
the difficulty. 

BUGS 
Filenames with the characters = : @ will not work. Commands that are 
directly executed by the shell, notably ed(1), are ineffectual across newlines in 
make. The syntax (lib(file1.0 file2.0 file3.o) is illegal. You cannot build 
lib(file.o) from file.o. The macro $(a:.o=.c) does not work. Named pipes are 
not handled well. 
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NAME 
makealiases, makewhatis — generate man page databases 


SYNOPSIS 
/usr/lib/makealiases 
/usr/lib/makewhatis 

DESCRIPTION 
makealiases scans the files in /usr/catman, and creates the alias file 
/usr/catman/aliases. makewhatis also scans the files in /usr/catman and 
creates the file /usr/catman/whatis for use by /usr/bin/whatis, 
/usr/bin/apropos, and /usr/bin/man. Any time new manual pages are 
installed within /usr/catman, the aliases and whatis databases should be 
regenerated. 

FILES 
/usr/catman/aliases —_ the man page aliases 
/usr/catman/whatis the whatis database 
/usr/catman/man?/* _ preformatted manual pages 


SEE ALSO 
man(1), whatis(1), apropos(1) 
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NAME 
makedev — make system special files 


SYNOPSIS 
/dev/MAKEDEYV [-n] device... 


DESCRIPTION 
MAKEDEVis a shell script used to install special files. It resides in the /dev 
directory, the usual location of special files. All device special files are created 
relative to the current directory. You must change directories to the target 
location before running MAKEDEV. 


If the -n option is specified as the first argument to MAKEDEY, the actions 
are only printed and not executed. Since all devices are created using 
mknod(1M), MAKEDEV (without the -n option) can be used only by the 
superuser. 


Arguments to MAKEDEV are usually of the form device-name* where device- 
name is one of the supported devices listed in section 7 of the manual and the 
asterisk (*) represents a logical unit number. In the following example, zd is 
the device name and 0 is the logical unit number. 


# cd /dev 
# ./MAKEDEV zd0 


The following special arguments create assorted collections of devices: 


auto Create device nodes for all devices found by the autoconfigure process 
at boot time. The devices created are limited only by the kernel /O 
configuration. 


std Create the standard devices for the system. These devices are 
/dev/console, /dev/syscon, /dev/altcon, /dev/consmem, /dev/tty, 
/dev/mem, /dev/kmem, /dev/null, /dev/swap, /dev/usclk, /dev/log, 
/dev/getpty, |dev/spx, [dev/cmpt, and /dev/vtoc. 


local Create those devices specific to the local site. This request causes the 
shell script /dev/ MAKEDEV local to be executed. Any site specific 
commands should be included in this file. 


DIAGNOSTICS 
Messages are either self-explanatory, or are generated by one of the programs 
called from the script. . 


SEE ALSO 
sh (1), config(1M), mknod(1M), intro(7) 
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NAME 


makekey — generate encryption key 


SYNOPSIS 


/usr/lib/makekey 


DESCRIPTION 


makekey improves the usefulness of encryption schemes that depend on a 
key by increasing the amount of time required to search the key space. It first 
attempts to read 8 bytes for its key (the first 8 input bytes), then it attempts to 
read 2 bytes for its salt (the last 2 input bytes). The output depends on the 
input in a way intended to be difficult to compute (that is, to require a sub- 
stantial fraction of a second). 


The first 8 input bytes (the input key) can be arbitrary ASCII characters. The 
last 2 (the salt) are best chosen from the set of digits, ., /, and upper- and low- 
ercase letters. The salt characters are repeated as the first two characters of 
the output. The remaining 11 output characters are chosen from the same set 
as the salt and constitute the output key. 


The transformation performed is essentially the following: the salt is used to 
select one of 4,096 cryptographic machines all based on the National Bureau 
of Standards DES algorithm, but broken in 4,096 different ways. Using the 
input key as key, a constant string is fed into the machine and recirculated a 
number of times. The 64 bits that come out are distributed into the 66 output 
key bits in the result. 


makekey is intended for programs that perform encryption. Usually, its 
input and output will be pipes. 


SEE ALSO 


NOTES 
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ed(1), erypt(1), vi(1), passwd(4) 


makekey can produce different results depending upon whether the input is 
typed at the terminal or redirected from a file. 


This command is available only in the United States. 
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NAME 

man — display on-line man pages 
SYNOPSIS 

man -k keyword ... 


man -f file ... 
man [ -P path ] [-] [ section ] title ... 


DESCRIPTION 
The man program provides on-line access to the man pages in the Reference 
Manual. When the man command is issued, it formats a specified set of man- 


ual pages. 


When given the option -k and a set of keywords, man prints out a one-line 
synopsis of each manual section whose listing in the table of contents contains 
those keywords. This is the same as apropos(1). 


When given the option -f and a list of files, man attemps to locate manual sec- 
tions related to those files, printing out the table of contents lines for those 
sections. This is the same as whatis(1). 


When neither -k nor -f is specified, man formats a specified set of manual 
pages. If a section identifier is given, man looks in that section of the manual 
for the given titles. 


The -P option allows you to specify a path for the location of the man pages to 
be displayed. 

section is an Arabic section number such as 1. The number can be followed by 
a one-letter classifier (such as Ig, which indicates a graphics program in sec- 
tion 1) or by a three-letter classifier (such as 3pps, which indicates a routine in 
the Paralle] Programming Library in section 3). 


If section is omitted, man searches all sections of the manual, giving prefer- 
ence to commands over subroutines in system libraries, and printing the first 
section it finds, if any. 

If the standard output is a terminal or if the flag - is given, man pipes its out- 
put through cat(1) and through pg(1) to cause output to stop after each page. 
Press Return to continue scrolling the output. 


The use of pg(1) as the pager can be changed by setting the environment vari- 
able PAGER. 


Manual pages aliases are kept in the /usr/catman/aliases file. 


FILES 
/usr/catman/man?/* 
/usr/catman/aliases 


SEE ALSO 
pg(1), apropos(1), whatis(1) 


BUGS 
The manual is supposed to be reproducible either on the phototypesetter or on 
a typewriter. However, on a typewriter some information is necessarily lost. 
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NAME 
mcs — manipulate the object file comment section 

SYNOPSIS 
mes [options] object-file ... 

DESCRIPTION 
The mes command manipulates the comment section (normally .comment) in 
an object file. It is used to add to, delete, print, and compress the contents of 
the comment section in an operating system object file. mcs must be given one 
or more of the options described below. It takes each of the options given and 
applies them in order to the object-files. 


If the object file is an archive, the file is treated as a set of individual object 
files. For example, if the -a option is specified, the string is appended to the 
comment section of each archive element. 


The following options are available. 


~a string Append string to the comment section of the object-files. If string 
contains embedded blanks, it must be enclosed in quotation 


marks. : 

-c Compress the contents of the comment section. All duplicate 
entries are removed. The ordering of the remaining entries is not 
disturbed. 

-d Delete the contents of the comment section from the object file. 


The object file comment section header is removed also. 


“nname Specify the name of the section to access. By default, mes deals 
with the section named.comment. This option can be used to 
specify another section. 


-p Print the contents of the comment section on the standard output. 
If more than one name is specified, each entry printed is tagged by 
the name of the file from which it was extracted, using the format 


filename:string. 
EXAMPLES 
mes -p file # Print file’s comment section 
mcs -a string file # Append string to file’s comment section 
FILES 
TMPDIR/mcs* Temporary files 
TMPDIR* Temporary files 


TMPDIR is usually /usr/tmp, but can be redefined by setting the environ- 
ment variable TMPDIR [see tempnam() in tmpnam(38)]. 


SEE ALSO 
cpp(1), a.out(4) 
NOTES 


mcs cannot add new sections or delete existing sections to executable objects 
with magic number 0413 [see a.out(4)]. 
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NAME 


menu — menu processor 


SYNOPSIS 


menu [menuname] 


DESCRIPTION 


The menu command initiates the ptx/ADMIN menu system. The initial menu 
can be called from the command line or it can be defined by the TFBEGMENU 
environment variable. 


menuname Name of the initial menu. 


The initial menu must be defined as an entry point in the global security 
table. The System Administrator uses this command to control where each 
user enters the menu system. 


The menu system looks for three optional environment control files before dis- 
playing the user’s initial menu. These three files are used to establish fixed 
values for environment variables unique to the menu system. The environ- 
ment variables appear in the following format: 


name=value 


The first of these files, /etc/tfenv, controls system-wide values that do not 
vary with each user and identifies where the components of the menu system 
are stored. 


For example, /etc/tfenv might include the following entries: 


TFADMBIN=/usr/tf/admbin 
TFADMF ILE=/usr/tf 
PATH=$PATH: STFBIN: STFADMBIN 


Note that the PATH variable is used by the menu system and by the shell to 
locate programs. 


The $TFADMFILE/etc/tfenv file establishes variables that control (that is, 
activate and deactivate) features in the menu system. This is an optional file. 
The environment variables that are normally in this file can be placed in the 
/etc/tfenv file, if desired. The $TFADMFILE/etc/tfenv contains the following 
environment variables: 


TFBEGMENU=clmain 
TFDSPCODE=No 
TFDSPMENU=Multiple 


The last file that the menu system reads is the user’s file $HOME/.tfenv. This 
file contains environment variables that are tailored for the user. For 
example, the file might contain the following entries: 


TFBEGMENU=mymenu 
TFDSPCODE=Yes 


These three control files (/ete/tfenv, $TFADMFILE/etc/tfenv, and 
$HOME|/.tfenv) allow the administrator to establish a user account with the 
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menu shell, tfimenush, as the user's initial program. It does not require any 
additional setup or modification in the user’s home directory. 


Environment Variables 


TFTERM Identifies the terminal type. 
TERM If TFTERM is not set, this variable identifies the terminal 
type. 


TERMINFO Identifies the location of the terminfo terminal descriptions. 
Normally you do not need to define this environment vari- 
able since the directory $TFADMFILE/terminfo is used by 
default. 


TFBEGMENU _sIf the command line does not include the name of an initial 
menu, this variable identifies the initia] menu for the user. 


TFBIN Identifies the directory where the menu system user pro- 
grams are located. 


TFADMBIN Contains the name of the directory where menu system 
binaries are stored. The System Administrator is the only 
authorized user. In some installations, TFBIN and 
TFADMBIN are set to the same value. 


TFADMFILE Contains the name of the head directory where the menu 
system subdirectories are stored. There are four important 


directories: 
etc control information 
misc error logs and dead messages 
edc compiled forms (in most cases) 
menu menu definitions (in most cases) 


TFEDCPATH Identifies directories that are alternate locations for the 
command description files. Directory names are separated 
with a colon in the string, similar to the PATH environment 
variable. 


TFMENUPATH Identifies a list of directories that are alternate locations for 
the menu definition files. Directory names are separated 
with a colon in the string similiar to the PATH environment 
variable. 


TFDSPMENU Identifies if the menu driver displays the top menu in the 
menu stack (TFDSPMENUSSingle), or uses the graphics 
mode to tile the top three menus on the menu stack 
(TFDSPMENU=Multiple). If this environment variable is not 
defined, the menu system defaults to the graphics mode. 


FILES 
$({TERMINFO)/[a-zYtermtype Terminal definition file 
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${({TFADMFILE}/menu/menuname 
/etc/passwd 

/etc/group 

/etc/tfenv 


$TFADMFILE/etc/tfenv 
$HOME/.tfenv 
${(TFADMFILE}/etc/task 
${(TFADMFILE}/menumsg 
${(TFADMFILE)/misc/dead.msg 
${TFADMFILE}/misc/errorlog 


SEE ALSO 
prompt(1M) 
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Default menu definition file 

System password file 

System group file 

Establishes menu system home direc- 
tories and other system-wide parame- 
ters 

Set menu system feature variables 
Override menu system feature variables 
Global security table 

System message files 

System dead message file 

System error message log 
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NAME 


MENUMSG(1M) 


menumsg — route user message to menu message queue 


SYNOPSIS 


menumag [-u user] [-t term] [message] 


DESCRIPTION 


The menumsg command allows a program or user to send a message to 
another user via the menu message queue. 


If the recipient is not logged onto the menu system, the messages are held in 
the queue until the recipient executes the menu system. 


-Uu user 


-tterm 


message 


FILES 


/etc/passwd 


Identifies the user who will receive the message. The user name 
must exist in the system password file (/etc/passwd). If the com- 
mand does not include a user name, the message is sent to the 
user who executed the menumsg command. Selection of a user 
name is optional. 


Identifies the terminal that will receive the message. If the com- 
mand does not include a terminal id, the message is sent to the 
terminal that executed the menumsg command. Selection of a 
terminal is optional. 


Text of the message. If the command does not include message 
text, the standard input is read. Message text is required. 


System password file 


${TFADMFILE}/menumsg System message files 
$(TFADMFILE}/misc/dead.msg System dead message file 


SEE ALSO 


menu(1M), tfnotify(1M) 
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NAME 
© merge — three-way file merge 
SYNOPSIS 
merge [ -p ] filel file2 file3 


DESCRIPTION 
merge incorporates all changes that lead from file? to file? into filel. The 
result goes to standard output if —p is present, into file otherwise. merge is 
useful for combining separate changes to an original. Suppose file? is the orig- 
inal, and both filel and file3 are modifications of file2. Then merge combines 
both changes. 


An overlap occurs if both fileI and file3 have changes in a common segment of 
lines. merge prints how many overlaps occurred and includes both alterna- 
tives in the result. The alternatives are delimited as follows: 

<<<<<<< filel 

lines in filel 


lines in file3 
>>>>>>> file3 


If there are overlaps, the user should edit the result and delete one of the 
alternatives. 


SEE ALSO 
co(1), diff3(1), diff(1), resmerge(1) 


GS NOTES 
Copyright 1982 by Walter F. Tichy. 
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NAME 
mesg — permit or deny messages 
SYNOPSIS 
mesg [-n ][-y ] 
DESCRIPTION 
mesg with argument n forbids messages via write(1) by revoking non-user 
write permission on the user’s terminal. mesg with argument y reinstates 
permission. All by itself, mesg reports the current state without changing it. 
FILES 
/dev/tty* 
SEE ALSO 
write(1) 
DIAGNOSTICS 
Exit status is 0 if messages are receivable, 1 if messages are not receivable, 2 
on error. 
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NAME 


message — puts its arguments on message line 


SYNOPSIS 


message [-t] [-p] [-o] [-b [n]] “[string]" 


DESCRIPTION 


The message command outputs its string arguments to the message line. If 
there is no string, the stdin input to message is used. Specifying -t causes 
the message to be removed after the next keypress. This is the default. Speci- 
fying —p causes the message to be displayed until another message is 
displayed. The -o flag forces message to “tee” its message to stdout. The -b 
[n], where n is an integer from 1 to 10, rings the terminal bell n times. The 
default is 1. If the terminal has no bell, the screen is flashed instead, if pos- 
sible. 


If the message command is being used solely for the bell or working indicator 
control, remember to give it a null string argument unless input is being piped 
toit. The string should always be the last argument. 


EXAMPLES 
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When the value entered in the field is wrong, ring the bell 3 times and then 
put up the invalid field message “Try again!” 


invalidmsg=‘message -b 3 "" ‘Try again! 
Put out a message to tell the user what is being done: 


done= ‘message hello has been set in your environment ‘ 
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NAME 


mkdir — make directories 


SYNOPSIS 


mkdir [ -m mode ] [ -p] dirname ... 


DESCRIPTION 


mkdir creates the named directories in mode 777. The mode will be altered 
by umask(1) unless the -m option is specified. 


Standard entries in a directory (the files . for the directory itself and .. for its 

parent) are made automatically. mkdir cannot create these entries by name. 

Creation of a directory requires write permission in the parent directory. 

The owner ID and group ID of the new directories are set to the process’s real 

user ID and the group ID of the parent directories, respectively. 

Two options apply to mkdir: 

-m_ This option allows users to specify the mode to be used for new direc- 
tories. Choices for modes can be found in chmod(1). 


-p With this option, mkdir creates dirname by creating all the non-existing 
parent directories first. 


EXAMPLES 


To create the subdirectory structure ltr/jd/jan, type this command: 
mkdir =p ltr/jd/jan 


SEE ALSO 


esh(1), ksh(1), sh(1), rm(1), umask(1), intro(2), mkdir(2) 


DIAGNOSTICS 


mkdir returns exit code 0 if all directories given in the command line were 
made successfully. Otherwise, it prints a diagnostic and returns non-zero. An 
error code is stored in errno. 
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NAME 


MKFS(1M) 


mkfs — construct a filesystem 


SYNOPSIS 


/ete/mkfs special size [ nsect [ ntrack [ blksize [ fragsize [ ncpg [ minfree [ 
rps [ nbpi]]]]]J]] 


DESCRIPTION 


mkfs constructs a filesystem by writing on the special file special. mkfs pro- 
vides an alternate interface to the newfs(1M) command, and can be used to 
initialize file systems on disks which have no VTOC. The numeric size specifies 
the number of sectors in the filesystem. mkfs builds a filesystem with a root 
directory and a lost+found directory (see fsck(1M)). The number of inodes is 
calculated as a function of the filesystem size. 


The following optional arguments allow finer control over the parameters of 


the filesystem: 
nsect Specifies the number of sectors per track on the disk. 
ntrack Specifies the number of tracks per cylinder on the disk. 
blksize Gives the primary block size for files on the filesystem. It must 
be a power of two, selected from 4096 or 8192. 
fragsize Gives the fragment size for files on the filesystem. Represents 
the smallest amount of disk space that will be allocated to a file. 
It must be a power of two, selected from the range 512 to 8192. 
nepg Specifies the number of disk cylinders per cylinder group. 
minfree Specifies the minimum percentage of free disk space allowed. 
Once the filesystem capacity reaches this threshold, only the 
superuser is allowed to allocate disk blocks. The default value is 
10%. 
rps Specifies the number of revolutions per second, if a disk does not 
revolve at 60 revolutions per second. 
nbpi Specifies the number of bytes per inode, if a filesystem will have 
more or less than the average number of files. Used to increase 
or decrease the number of inodes that are created. 
SEE ALSO 
newfs(1M), fsck(1M), tunefs(1M), dir(4), fa(4) 
BUGS 
There should be some way to specify bad blocks. 
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NAME 


mknod — build special file 


SYNOPSIS 


/etc/mknod name b | ¢ major minor 
/etc/mknod name p 


DESCRIPTION 


mknod makes a directory entry and corresponding inode for a special file. 


The first argument is the name of the entry. The operating system convention 
is to keep such files in the /dev directory. 


In the first case, the second argument is b if the special file is block-type 
(disks, tape) or c if it is character-type (other devices). The last two argu- 
ments are numbers specifying the major device type and the minor device 
(e.g., unit, drive, or line number). They may be either decimal or octal. The 
assignment of major device numbers is specific to each system. The informa- 
tion is contained in the system source file conf.c. You must be the superuser 
to use this form of the command. 


The second case is the form of the mknod that is used to create FIFO’s (a.k.a 
named pipes). 


SEE ALSO 
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NAME 


mkpwdbm — make a database for fast password lookup 


SYNOPSIS 


mkpwdbm [-fvps] 


DESCRIPTION 


FILES 


The mkpwdbm program generates a database that allows fast indexing into 
the /etc/ passwd file. If the optional /etc/ shadow file exists, mkpwdbm also 
generates a database allowing fast lookups into this file. 


Tf your machine has a large number of names (> 500) in the /etc/ passwd file, 
using the database files will speed lookups making use of the library routines 
that search these files. 


This command can be run only by the superuser. Normally it is run by a dae- 
mon program (/ete/pwdhd) and is not invoked manually. The options are as 
follows: 


-f Force creation of the database files. Normally the files will be 
updated only if they presently exist. 


~v Verbose option. The command is intended to be run by a daemon and 
typically generates no output. Using either the -f or the -v command 
line options allows error messages to be generated. The —v option 
also prints a count of names found in the data files. If the command 
finds duplicate names or user ids, they are displayed. 


-p Rebuild only the database for /etc/passwd. By default, the databases 
for both /etc/ passwd and /etc/shadow are built. 


8 Rebuild only the database for /etc/shadow. By default, the data- 
bases for both /etc/passwd and /etc/shadow are built. 


/etc/passwd 
/etc/passwd_dbm.dir 
/etc/passwd_dbm.pag 
etc/shadow 
/etc/shadow_dbm.dir 
/etc/shadow_dbm.pag 


SEE ALSO 


BUGS 
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/etce/pwdhd 


If you edit the password or shadow files by hand to add a user and do not alter 
the file byte count, the library routines might not be able to find the new user. 
Because other problems not related to the hashed database can occur when 
the files are edited by hand, you should avoid editing the files in this manner. 
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NAME 


mkvtoc — populate VTOC on disks 


SYNOPSIS 


/ete/mkvtoc [ -d arguments ] [ -g ] [ -f ] [ -s datafile ] disk disktype 


DESCRIPTION 
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mkvtoc populates the VTOC (volume table of contents) on disks. 
The following options apply to mkvtoc: 


-d Permits change to a single partition. arguments consist of a colon- 
separated list of entries similar to a line from datafile (described 
below). 


- The VTOC is initialized and the disk geometry is set from the file 
/etc/diskinfo/disktype.geom. This option must be supplied if the disk 
does not have a VTOC present. 


-f Allow partitions of type V.RESERVED to be changed. Use of this 
option is strongly discouraged. 


8 The VTOC is populated according to a datafile created by the user. 
The datafile format is described below. 


If no options are given, the VTOC is populated according to the specification of 
a default file, disktype in directory /etc/vtoc, where disktype was supplied on 
the command line. For example, for a 792-megabyte disk, the disktype specific 
would be m2382k and the default file used is /etc/vtoc/m2382k . 


The disk on which the VTOC is installed may be specified as a simple disk 
name such as zd0 or sd without any path prefix. If this form of disk is used, 
the appropriate path to a special device is generated automatically. Alterna- 
tively, the pathname to a character special device should be given. The char- 
acter special device may be a disk partition, the disk’s diagnostic device, or the 
prepartitioned disk device. (See vtoc(7)). 


The datafile contains one specification line for each partition, starting with 
partition 0. Lines beginning with an asterisk are treated as comments. A 
specification line is composed of position-dependent entries separated by white 
space. A line has the following format: 

partition type starting_sector size_in_sectors block_size frag_size 
The entries have the following values: 


partition The partition number: 0-254. 

type The partition type: a decimal number. The following are valid 
types: V_NOPART: 0, V_RAW: 1, V_BOOT: 2, V_RESERVED: 
3, V_FW: 4. 


starting sector The sector number on which the partition starts. 
size in sectors The number of sectors occupied by the partition. 
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The partition types have the following meanings: 


V_NOPART This partition number does not represent valid, useable disk 
space. A partition may be marked as V.NOPART to serve asa 
placeholder. Note that if the datafile contains less than the 
maximum possible number of partitions, the remainder are 
marked V_NOPART . 


V_RAW This is a regular partition. 
V_BOOT This is an area of disk reserved for a bootstrap. As such, 


filesystems should not be mounted here. V_BOOT is a descrip- 
tive tag and has no functional difference from V_RAW . 


V_RESERVED This is an area of the disk reserved for some disktype-specific 
purpose, such as bad block lists, diagnostic tracks, or the 
VTOC itself. Partitions of type V.RESERVED are treated dif- 
ferently than partitions of other types in that they may not be 
changed via the mkvtoc command, unless the -f flag is speci- 
fied on the command line. In general it is not wise to alter 
V_RESERVED partitions in any way, since various parts of the 
system depend on these disk sectors to be unchanged. 


V_FW This is an area of disk reserved for system controller firmware. 
As such, filesystems should not be mounted here. V_FW is a 
descriptive tag and has no functional difference from V_RAW . 


Anumber of sanity checks are performed on the new VTOC before it is written 
to disk. For example, the block size and fragment sizes are checked against 
system norms and the total number of sectors in partitions are checked to 
make sure they do not exceed the size of the disk. In addition, if any two parti- 
tions have sectors which overlap, the mkvtoc command will fail. 


SEE ALSO 
prtvtoc(1M) 


WARNINGS ; 
If a disk which has not previously contained a VTOC has data present in sec- 
tors 16 through 31, that data will be overwritten by the VTOC. 
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NAME 


monitor — monitor system activity 


SYNOPSIS 


/ete/monitor [-c n][-in][-pxr][-+][-f] 


DESCRIPTION 


monitor displays various measures of system activity. The first portion of the 
display is a set of bar graphs of processor activity, one for each processor plus 
a graph for the system labeled “Total.” Each bar indicates the percentage of 
time the respective processor was busy and is composed of two symbols, ‘=’ for 
system time and ‘-’ for user time. The rest of the display contains a number of 
user selectable groups of system activity monitors. To exit monitor, a 
Return, Linefeed, or the letter q may be typed. A Ctrl-L will cause the screen 
to be redrawn. 


monitor’s command-line options are as follows: 


-en Specifies the number of columns to use for displaying the processor 
bar graphs. Valid choices for n are 1, 2, and 3. 


-in Specifies the length of the interval (in seconds) td sleep between 
updates of the screen. The default is 1. 

-pn Ifthe monitor process is running with sufficient privileges, it will 
“affinity” itself to processor n. The default is “no affinity’, i.e. the 
operating system schedules monitor like any other process, running 
it across all processors. (See tmp_affinity(2SEQ)). 

+ Specifies that terse activity monitor descriptions should be used. This 
allows more information to fit on the screen. 


-f Indicates that two screens are to be used; one for the processor graphs 
and one for the activity monitors. While monitor is running, typing 
an f will flip between the two screens. 

Activity monitors are as follows (labels in -t format are given in parentheses): 


Total User Time (usr %) 
Time the system spent in user mode expressed as percent of one pro- 
cessor. 
Total System Time (sys %) 
Time the system spent in system mode expressed as percent of one 
processor. 
Total Time (tot %) 
Sum of user and system time expressed as percent of one processor. 
Number of Procs (procs) 
Number of processes in the system (occupied process table entries). 
Running Procs (on p) 
Number of processes currently running on a processor. 
Runnable Procs (runq) 
Number of processes that are runnable and waiting on the run queue 
to be dispatched to a processor. 
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Fast Wait (wait) 
Number of processes that are waiting on disk I/O, page I/O, or a kernel 
resource. 


Sleeping Procs (sleep) 
Number of processes that are sleeping. 
Swapped Procs (swapped) 
Number of processes that are swapped to disk. 
Procs FS io Wait (fs io) 
Number of processes waiting for filesystem I/O. These are included in 
FastWait total. 
Procs Phy io Wait (phys io) 
Number of processes waiting for raw disk I/O. These are included in 
FastWait total. 
System Calls (sysc) 
Number of system calls per second. 
Context Switches (csw) | 
Number of context switches per second. 
Interrupts (intr) 
Number of interrupts per second. 
Traps (traps) 
Number of traps per second. 
Forks (fork) 
Number of forks per second. 


Vforks (vfork) 
Number of vforks per second. 


Execs (exec) 
Number of execs per second. 


Disk Transfers (dk xf) 
Number of disk transfers per second. 


Disk KBytes (dk KB) 
Number of kilobytes transferred per second. 


TTY Chars In (ttyin) 
Number of characters received on TTY lines per second. 


TTY Chars Out (ttyout) 
Number of characters transmitted on TTY lines per second. 


Page Faults (pf) 
Number of page faults per second. 


Free Page Recs (pg rec) 
Number of page reclaims from the free list per second. The sum of 
page reclaims from the free list and the dirty list equals the total 
reclaims (i.e. minor page faults). 

Dirty Page Recs (pgdrec) 
Number of page reclaims from the dirty list per second. The sum of 
page reclaims from the dirty list and the free list equals the total 
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reclaims (i.e. minor page faults). 
Page Ins (pgin) 
Number of page ins (major faults) per second. 
Pages Paged In (ppgin) 
Number of pages paged in per second. 
Page Outs (pgout) 
Number of page outs per second. 
Pages Paged Out (ppgout) 
Number of pages paged out per second. 
Swap Ins (sw in) 
Number of processes swapped in per second. 
Pages Swapped In (pswin) 
Number of pages swapped in per second. 
Swap Outs (sw out) 
Number of processes swapped out per second. 
Pages Swapped Out (pswout) 
Number of pages swapped out per second. 
Deficit (deficit) 
Virtual memory deficit in Kbytes 
Free Memory (free) 
Free memory in Kbytes. 
Dirty Memory (dirty) 
Dirty memory in Kbytes 
Total Virtual Mem (tot vm) 
Sum of virtual sizes of all processes. 
FS Blk Reads (fs brd) 
Number of actual disk reads initiated by the filesystem. : 
FS BIk Writes (fs bwt) 
Number of actual disk writes initiated by the filesystem. 
FS Read Hit (fs rdh) 
Percentage of filesystem read requests that were satisfied from the 
buffer cache. 
FS Write Hit (fs wth) 
Percentage of filesystem write requests that did not result in an actual 
disk write. 
Raw Reads (raw rd) 
Number of raw device reads from all devices. 
Raw Writes (raw wt) 
Number of raw device writes from all devices. 
Raw Read KB (raw rKB) 
Number of kilobytes (KB) transferred via raw device reads. 
Raw Write KB (raw wKB) : 
Number of kilobytes (KB) transferred via raw device writes. 
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Locks Used (Ickent) 
Number of record/file locks (see lockf(3C) or fentl(2)) currently in use. 


Percent Locks Used (%locks) 
The percentage of available record/file locks (see lockf(3C) or fentl(2)) 
currently in use. 


Message Ops (msgops) 
Number of System V message queue operations per second. 


Semaphore Ops (semops) 
Number of System V semaphore operations per second. 


monitor samples dynamically changing data. From time to time, some slight 
anomalies may appear. The most obvious one is that occasionally the number 
of processes on processor will be greater than the number of processors in the 


system. 
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NAME 
more - view a file one full screen at a time 
SYNOPSIS 
more [ -cdflsurw ] [ -n ] [ +linenumber ] [ +/pattern ][ name... ] 
DESCRIPTION 
The more filter allows examination of continuous text one full screen at a 
time. It normally pauses after each full screen, printing "--More-—" at the 
bottom of the screen. If the user then presses the RETURN key, one more line 
is displayed. If the user presses the SPACEBAR, another full screen is 
displayed. Other possibilities are described below. 


The command line options include the following: 


-n An integer which is the size (in lines) of the window which more is 
to use instead of the default. 
-c more draws each page by beginning at the top of the screen and 


erasing each line just before it displays a new line. This avoids 
scrolling the screen, making it easier to read while more is writ- 
ing. This option is ignored if the terminal does not have the ability 
to clear to the end of a line. 


-d more prompts with the message "Hit space to continue, Del 
to abort” at the end of each full screen. This is useful if more is 
being used as a filter in some setting, such as a class, where many 
users may be inexperienced. 


-f This option causes more to count logical lines instead of screen 
lines. Long lines are not folded. This option is recommended if 
nroff output is being piped through ul, since the latter may gener- 
ate escape sequences. These escape sequences contain characters 

- that would ordinarily occupy screen positions, but that do not print 
when they are sent to the terminal as part of an escape sequence. 
Thus, more may think that lines are longer than they actually are 
and fold lines erroneously. 


-l Does not treat Ctrl-L (FORMFEED) specially. If this option is not 
given, more pauses after any line that contains a Ctrl-L, as if the 
end of a full screen had been reached. Also, if a file begins with a 
FORMFEED, the screen is cleared before the file is printed. 


6 Squeezes multiple blank lines from the output, producing only one 
blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 


—u Normally, more handles underlining, such as that produced by 
nroff in a manner appropriate to the particular terminal. If the 
terminal can perform underlining or has a stand-out mode, more 
outputs appropriate escape sequences to enable underlining or 
stand-out mode for underlined information in the source file. The 
-u option suppresses this processing. 


+r The -r option causes control characters to be displayed as *C, 
where C stands for any such control character. Normally, more 
ignores contral characters that it does not interpret in some way. 
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-w With -w, more prompts and waits for any key to be struck before 
exiting. Normally, more exits when it comes to the end of its 
input. 

+linenumber 


Starts up at linenumber. 


+/patiern Starts up two lines before the line containing the regular expres- 
sion pattern. 


more uses the /usr/lib/terminfo/? database files for the terminal character- 
istics and the default window size. For example, on a terminal capable of 
desplaying 24 lines, the default window size is 22 lines. 


more looks at the environment variable, MORE, to preset any flags desired. 
For example, if you prefer to view files using the -c mode of operation, the 
shell command, MORE=-c in the .profile file causes all invocations of more to 
use this mode. 


If more is reading from a file, rather than a pipe, a percentage is displayed 
along with the "--More--" prompt. This gives the fraction of the file (in char- 
acters, not lines) that has been read so far. 


Other sequences which may be typed when more pauses, and their effects, are 
as follows (i is an optional integer argument, defaulting to 1): 


i<space> Displays: more lines, (or another full screen if no arguments is 


given). 

Ctrl-D Displays 11 more lines (scrolls). If i is given, then the scroll size is 
set toi. 

d Same as Ctrl-D. 

iz Same as typing a space except that i, if present, becomes the new 
window size. 

is Skips / lines and prints a full screen of lines. 

if Skips i full screens and prints a full screen of lines. 

iCtrI-B Skips backwards i full screens and prints a full screen of lines. 

tb Same as Ctrl-B. 

qorQ Exits from more. 

= Displays the current line number. 

v Starts up the screen editor vi at the current line. 

hor? Help command; gives a description of all the more commands. 


i/expr Searches for the ith occurrence of the regular expression expr. If 
there are less than i occurrences of expr, and the input is a file 
(rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a full screen is displayed, starting two lines 
before the place where the expression was found. You can use the 
ERASE and KILL characters to edit the regular expression. Eras- 
ing back past the first column cancels the search command. 


in Searches for the ith occurrence of the last regular expression 
entered. 
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° (Single quotation mark) Goes to the point from which the last 
search started. If no search has been performed in the current file, 
this command goes back to the beginning of the file. 


lcommand 
Invokes a shell with command. The % and! characters in com- 


mand are replaced with the current filename and the previous shell 
command respectively. If there is no current filename, % is not 
expanded. The sequences, "\%" and "\!", are replaced by "%" and 
"I" respectively. 

im Skips to the ith next file given in the command line (skips to last 
file if n doesn’t make sense). 

isp Skips to the ith previous file given in the command line. If this 
command is given in the middle of printing out a file, more goes 
back to the beginning of the file. Ifi doesn’t make sense, more 
skips back to the first file. If more is not reading from a file, the 
bell rings and nothing else happens. 


f Displays the current filename and line number. 
‘qor:Q Exits from more (same as q or Q). 
. Repeats the previous command. 


The commands take effect immediately; you do not need to press the RETURN 
key. Up to the time when the command character itself is given, you can press 
the KILL character to cancel the numerical argument being formed. In addi- 
tion, you can press the ERASE character to redisplay the "--More-- (xx%)" 
message. 

The terminal is set to noecho mode by this program so that the output can be 
continuous. This means that what you type does not show on your terminal, 
except for the slash (/) and exclamation (!) commands. 


If the standard output is not a teletype, more acts just like cat, except that a 
header is printed before each file, if there is more than one file. 


A sample usage of more in previewing nroff output would be: 
nroff -ms +2 doc.n | more -8 


FILES 
/usr/lib/terminfo/?/* terminal information database 
/usr/ib/more.help help.file 

SEE ALSO 


NOTES 


ksh(1), sh(1), esh(1), environ(5) 


Before displaying a file, more attempts to detect whether the file is an 
unprintable binary file such as a directory or an executable binary image. If 
more concludes that a file is unprintable, more refuses to print it. However, 
more cannot detect all possible kinds of unprintable files. 
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NAME 


mount, umount — mount and unmount filesystems 


SYNOPSIS 


/ete/mount [-r] [-f fstyp] special directory 
/etc/mount 

/etchumount special 

/etc/umount directory 


DESCRIPTION 


Filesystems other than root (/) are considered removable in the sense that 
they can be either available to users or unavailable. mount announces to the 
system that special, a block special device, is available to users from the 
mount point directory. The directory must already exist; it becomes the name 
of the root of the newly mounted special. 


mount, when entered with arguments, adds an entry to the table of mounted 

devices, /etc/mnttab. umount removes the entry. If invoked with no argu- 

ments, mount prints the entire mount table. If invoked with any of the fol- 

lowing partial argument lists, mount will search /etc/fstab to fill in the miss- 

ing arguments: special or directory. ; 

The following options are available: 

+r Indicates that special is to be mounted read-only. If special is 
write-protected, this flag must be used. 

-ffetyp Indicates that fstyp is the filesystem type to be mounted. If this 
argument is omitted, it defaults to the root fstyp. 

special _Indicates the block special device that is to be mounted on direc- 
tory. 

directory Indicates the directory mountpoint for special. (The directory must 
already exist.) 

umount announces to the system that the previously mounted special is to be 

made unavailable. If invoked with directory, umount will search /etc/fstab 

to fill in the missing argument(s). 

mount can be used by any user to list mounted filesystems. Only a superuser 

can mount and unmount filesystems. 


FILES , 
/etc/mnttab Mount table 
/ete/fstab Filesystem table 
SEE ALSO 


fuser(1M), setmnt(1M), mount(2), umount(2), fstab(4), mnttab(4) 


DIAGNOSTICS 
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If the mount(2) system call fails, mount prints an appropriate diagnostic. 
mount issues a warning if the filesystem to be mounted is currently labeled 
under another name. 


umount fails if special is not mounted or if it is busy. special is busy if it con- 
tains an open file or some user’s working directory. In such a case, you can 
use fuser(1M) to list and kill processes that are using special. 
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NAME 


mountall, umountall — mount, unmount multiple filesystems 


SYNOPSIS 


/etc/mountall [ -f <fstype> ] 
/etc/umountall [ -k ] [ -f <fstype> ] 


DESCRIPTION 


FILES 


@& SEE ALSO 


These commands may be executed only by the superuser. 

mountall is used to mount filesystems according to the filesystem-table, 

/etc/ fstab. 

The -f option will limit mounting and unmounting to the filesystem type 
specified. Without this option all mountable (unmountable) filesystems will be 
mounted (unmounted). 

Before each filesystem is mounted, it is checked using fsstat(1M) to see if it 
appears mountable. Filesystems that have not been marked "clean" by a 
proper shutdown or umount will be checked, using fsck(1M), before the 
mounts are attempted. Any entry in /etc/fstab for the root filesystem (/)is 
ignored. : 

umountall causes all mounted filesystems except root to be unmounted. The 
-k option sends a SIGKILL signal, via fuser({1M), to processes that have open 
files. 


/etc/fstab 


sysadm(1), fsck(1M), fsstat(1M), fuser(1M), mount(1M), signal(2), fstab(4) 


DIAGNOSTICS 


No messages are printed if the filesystems are mountable and clean, or if the 
filesystems are already mounted. 


Error and warning messages come from fsck(1M), fsstat(1M), and 
mount(1M). 
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NAME 
) mt — magnetic tape manipulating program 
SYNOPSIS 
mt [ -f tapename ] command [ count ] 


DESCRIPTION 
mt is used to give commands to a magnetic tape drive. Ifa tape name is not 
specified, the environment variable TAPE is used. If TAPE does not exist, mt 
uses the device /dev/rmt/xt0. Note that tapename must reference a raw (not 
block) tape device. By default, mt performs the requested operation once. 
Operations may be performed multiple times by specifying count. 


The available commands are listed below. Only as many characters as are 
required to uniquely identify a command need be specified. 


eof, weof Write count end-of-file marks at the current position on the 
tape. 
fsf Forward space count files. 
fer Forward space count records. 
bsf Back space count files. 
bsr Back space count records. 
rewind Rewind the tape (count is ignored). 


offline, rewoffl Rewind the tape and place the tape unit off-line (count is 


& ignored). 
retension, ret Retension the tape. This command is used for streamer 
tapes and should be done once per data access on 5” drives 
to minimize tape stretch. 


eod, seod Spaces to end of valid data. Used (possibly mandatory) on 
streamer tape drives to append data to the logical end of 
tape. 

noret Don’t retension the tape this time. Streamer tapes are nor- 


mally retensioned once on the first physical I/O operation fol- 
lowing insertion of the tape into the drive. To disable this 
automatic retensioning, issue this command between insert- 
ing the tape and beginning I/O operations. Automatic tape 
retensioning resumes with the next tape insertion. 


status Print status information about the tape unit. (This is not 
supported on all tape units.) 
erase Erase the tape. 


mt returns a 0 exit status when the operation(s) were successful, 1 if the com- 
mand was unrecognized, and 2 if an operation failed. 


FILES 
/dev/rmt/* Raw magnetic tape interface 


SEE ALSO 
© dd(1M), ioctl(2), environ(5), mtio(7) 
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BUGS 
-t is a synonym for -f on the command line, for backwards compatibility. © 
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NAME 
mvdir — move a directory 


SYNOPSIS 
/ete/mvdir dirname name 


DESCRIPTION 
mvdir moves directories within a filesystem. dirname must be a directory. If 
name does not exist, it will be created as a directory. If name does exist and is 
a directory, dirname will be created as name/dirname. dirname and name 
may not be on the same path; that is, one may not be subordinate to the other. 
For example, the following command is legal: 

mvdir x/y x/z 

The next command is not legal: 


mvdir x/y x/y/z 


SEE ALSO 
mkdir(1), mv(1) 


WARNINGS 
Only the superuser can use mvdir. 
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NAME 


nawk — pattern scanning and processing language 


SYNOPSIS 


nawk [-Fr] [parameter...] prog’) [-f progfile] [file...] 


DESCRIPTION 
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nawk is a new version of awk that provides capabilites unavailable in previ- 
ous versions. This version will become the default version of awk in the next 
major UNIX system release. 
The -Fr option defines the input field separator to be the regular expression 
re. 
parameters in the form x=... y=... may be passed to nawk, where x and y are 
nawk built-in variables (see list below). 
nawk scans each input file for lines that match any of a set of patterns speci- 
fied in prog. The prog string must be enclosed in single quotes (’) to protect it 
from the shell. For each pattern in prog, there may be an associated action 
performed when a line of a file matches the pattern. The set of pattern-action 
statements may appear literally as prog or in a file specified with the -f prog- 
file option. 
Input files are read in order; if there are no files, the standard input is read. 
The filename — means the standard input. Each input line is matched against 
the pattern portion of every pattern-action statement; the associated action is 
performed for each matched pattern. 
An input line is normally made up of fields separated by white space. (This 
default can be changed by using the FS built-in variable or the -F re option.) 
The fields are denoted $1, $2, and so on; $0 refers to the entire line. 
A pattern-action statement has this form: 

pattern { action } 
Either pattern or action may be omitted. If there is no action with a pattern, 
the matching line is printed. If there is no pattern with an action, the action 
is performed on every input line. 
Patterns are arbitrary Boolean combinations (!, | |, &&, and parentheses) of 
relational expressions and regular expressions. Arelational expression is one 
of the following: 

expression relop expression 

expression matchop regular expression 
Arelop is any of the six relational operators in C; a matchop is either ~ (con- 
tains) or !~ (does not contain). Aconditional is an arithmetic expression, a 
relational expression, the special expression 


var in array, 


or a Boolean combination of these. 


The special patterns BEGIN and END may be used to capture control before 
the first input line has been read and after the last input line has been read 


respectively. 
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Regular expressions are as in egrep [see grep(1)]. In patterns, they must be 
surrounded by slashes. Isolated regular expressions in a pattern apply to the 
entire line. Regular expressions may also occur in relational expressions. A 
pattern may consist of two patterns separated by a comma. In this case, the 
action is performed for all lines between an occurrence of the first pattern and 
the next occurrence of the second pattern. 


A regular expression may be used to separate fields by using the —-F re option 
or by assigning the expression to the built-in variable FS. The default is to 
ignore leading blanks and to separate fields by blanks and/or tab characters. 
However, if FS is assigned a value, leading blanks are no longer ignored. 


Other built-in variables include the following: 


ARGC Command line argument count 

ARGV Command line argument array 

FILENAME Name of the current input file 

FNR Ordinal number of the current record in the current file 
FS Input field separator regular expression (default blank) 
NF Number of fields in the current record 

NR Ordinal number of the current record 

OFMT Output format for numbers (default %.6g) 

OFS Output field separator (default blank) 

ORS Output record separator (default new-line) 

RS Input record separator (default new-line) 


An action is a sequence of statements. A statement may be one of the follow- 
ing: 

if ( conditional ) statement [ else statement ] 

if ( subscript in array ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement 

for ( var in array ) statement 

delete array[subscript] 


break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 


print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 
exit [expr] # skip the rest of the input; exit status is expr 
return [expr] 


Statements are terminated by semicolons, new-lines, or right braces. An 
empty expression-list stands for the whole input line. Expressions take on 
string or numeric values as appropriate, and are built using the operators +, -, 
*, /, %, and concatenation (indicated by a blank). The C operators ++, —, +=, 
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-=, *=, /=, and %= are also available in expressions. Variables may be scalars, 
array elements (denoted x[iJ), or fields. Variables are initialized to the null 
string or zero. Array subscripts may be any string, not necessarily numeric; 
this allows for a form of associative memory. String constants are quoted ("). 


The print statement prints its arguments on the standard output, or on a file 
if >expression is present, or on a pipe if | cmd is present. The arguments are 
separated by the current output field separator and terminated by the output 
record separator. The printf statement formats its expression list according 
to the format [see printf(3S)]. 


nawk has a variety of built-in functions: arithmetic, string, input/output, and 
general. 


The arithmetic functions are atan2, cos, exp, int, log, rand, sin, sqrt, and 
srand. int truncates its argument to an integer. rand returns a random num- 
ber between 0 and 1. srand (expr) sets the seed value for rand to expr or uses 
the time of day if expr is omitted. 


The string functions are as follows: 


gsub(for, repl, in) Behaves like sub (see below), except that it replaces succes- 
sive occurrences of the regular expression (like the ed global 
substitute command). 


index(s, t) Returns the position in string s where string ¢ first occurs, or 
0 if it does not occur at all. 


length(s) Returns the length of its argument taken as a string, or of 
the whole line if there is no argument. 


match(s, re) Returns the position in string s where the regular expression 
re occurs, or 0 if it does not occur at all. RSTART is set to the 
starting position (which is the same as the returned value), 
and RLENGTH is set to the length of the matched string. 


split(s, a, fs) Splits the string s into array elements a[7], a[2], a[n], and 
returns n. The separation is done with the regular expres- 
sion fs or with the field separator FS if fs is not given. 


sprintf(fmt, expr, expr, ...) 
Formats the expressions according to the printf(3S) format 
given by fmt and returns the resulting string. 


sub(for, repl, in) Substitutes the string repl in place of the first instance of the 
regular expression for in string in and returns the number of 
substitutions. Ifin is omitted, nawk substitutes in the cur- 
rent record ($0). 

substr(s, m,n) Returns the n-character substring of s that begins at posi- 
tion m. 

The input/output and general functions are as follows: 

close(filename) Closes the file or pipe named filename. 


cmd | getline _ Pipes the output of emd into getline; each successive call to 
getline returns the next line of output from cmd. 
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getline Sets $0 to the next input record from the current input file. 
getline <file Sets $0 to the next record from file. © 
getline var Sets variable var instead. 


getline var <file Sets var from the next record of file. 
system(cmd) Executes cmd and returns its exit status. 


All forms of getline return 1 for successful input, 0 for end of file, and —1 for an 
error. 


nawk also provides user-defined functions. Such functions may be defined (in 
the pattern position of a pattern-action statement) as follows: 


function name(args,...) { stmts } 
func name(args,...) { stmts } 


Function arguments are passed by value if scalar, and by reference if array 
name. Argument names are local to the function; all other variable names are 
global. Function calls may be nested and functions may be recursive. The 
return statement may be used to return a value. 


EXAMPLES 
Print lines longer than 72 characters: 


length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 
Same, with input fields separated by comma anW/or blanks and tabs: 


BEGIN { FS = ",[{ \t]*I[ \t]+" } 
{ print $2, $1 } 


Add up first column, print sum and average: 


{ s += $1 } 
END { print "sum is", s, " average is", s/NR } 


Print fields in reverse order: 

{ for (i = NF; i > O; --i) print Si } 
Print all lines between start/stop pairs: 

/start/, /stop/ 
Print all lines whose first field is different from previous one: 


$1 != prev { print; prev = $1 } 
Simulate echo(1): 
BEGIN { 
for (i = 1; i < ARGC; i++) 
printf "%s", ARGV[i] 
printf "\n" 
exit 


} 
Print file, filling in page numbers starting at 5: 
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/Page/ { $2 = n+t+; } 
{ print } 
command line: nawk -f program n=5 input 
SEE ALSO 
awk(1), grep(1), lex(1), sed(1), printf(3S) 
BUGS 
Input white space is not preserved on output if fields are involved. 


There are no explicit conversions between numbers and strings. To force an 
expression to be treated as a number, add 0 to it. To force an expression to be 
treated as a string, concatenate the null string ("") to it. 
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NAME 


ncheck — generate pathnames from i-numbers 


SYNOPSIS 


/etce/ncheck [ -i i-numbers ] [-a ][-s] [ filesystem ] 


DESCRIPTION 


ncheck with no arguments generates a pathname vs. i-number list of all files 
on a set of default filesystems (see /etc/checklist ). Names of directory files are 
followed by /.. 


The options are as follows: 
-i Limits the report to only those files whose i-numbers follow. 
-a Allows printing of the names. and .., which are ordinarily suppressed. 


8 Limits the report to special files and files with set-user-ID mode. This 
option may be used to detect violations of security policy. 


filesystem must be specified by the fileystem’s special file. 
The report should be sorted so that it is more useful. 


SEE ALSO 
* sort(1), fack(1M) 


DIAGNOSTICS 
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If the filesystem structure is not consistent, 2? denotes the “parent” of a par- 
entless file and a pathname beginning with ... denotes a loop. 
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newform — change the format of a text file 


SYNOPSIS 
newform [-s] [-itabspec] [~otabspec] [-bn] [-en] [-pn] [-an] [-f] [-cchar] 
[-In] [files] 

DESCRIPTION 
newform reads lines from the named files (or from the standard input if no 
input file is named) and reproduces the lines on the standard output. Lines 
are reformatted in accordance with command line options in effect. 


Except for -s, command line options may appear in any order, may be 
repeated, and may be intermingled with the optional files. Command line 
options are processed in the order specified. This means that option sequences 
like -e15 -160 will yield results different from -160 -e15. Options are applied 
to all files on the command line. 


-itabspec 


-otabspec 


Shears off leading characters on each line up to the first tab and 
places up to 8 of the sheared characters at the end of the line. If 
more than 8 characters (not counting the first tab) are sheared, the 
eighth character is replaced by a * and any characters to the right 
of it are discarded. The first tab is always discarded. 


An error message and program exit occurs if this option is used on 
a file without a tab on each line. The characters sheared off are 
saved internally until all other options specified are applied to.that 


line. The characters are then added at the end of the processed 
line. 


For example, to convert a file with leading digits, one or more tabs, 
and text on each line, to a file beginning with the text, all tabs after 
the first expanded to spaces, padded with spaces out to column 72 
(or truncated to column 72), and the leading digits placed starting 
at column 73, the command would be as follows: 


newform -s -i -] ~a -e filename 


Input tab specification: expands tabs to spaces, according to the 
tab specifications given. tabspec recognizes all tab specification 
forms described in tabs(1). In addition, tabspec can be ~-, in which 
newform assumes that the tab specification is to be found in the 
first line read from the standard input (see fepec(4)). If no tabspec 
is given, tabspec defaults to-8. A tabspec of -0 expects no tabs; if 
any are found, they are treated as -L 


Output tab specification: replaces spaces by tabs, according to the 
tab specifications given. The tab specifications are the same as for 
~itabspec. If no tabspec is given, tabspec defaults to -8. A tabspec 
of -O means that no spaces will be converted to tabs on output. 


Truncate n characters from the beginning of the line when the line 
length is greater than the effective line length (see -In). Default is 
to truncate the number of characters necessary to obtain the effec- 
tive line length. The default value is used when -b with no n is 
used. This option can be used to delete the sequence numbers from 
a COBOL program as follows: 
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newform -I1 -b7 filename 


-en Same as -bn except that characters are truncated from the end of 
the line. 
-pn Prefix n characters (see -ck) to the beginning of a line when the 


line length is less than the effective line length. Default is to prefix 
the number of characters necessary to obtain the effective line 


length. 
-an Same as —pn except characters are appended to the end of a line. 
-f Write the tab specification format line on the standard output 


before any other lines are output. The tab specification format line 
that is printed will correspond to the format specified in the last -o 
option. If no -o option is specified, the line that is printed will con- 
tain the default specification of -8. 


-ck Change the prefix/append character tok. Default character for k is 
@ space. 
-ln Set the effective line length to n characters. Ifn is not entered, -I 


defaults to 72. The default line length without the -l option is 80 
characters. Note that tabs and backspaces are considered to be one 
character (use -i to expand tabs to spaces). 


The -11 option must be used to set the effective line length shorter than any 
existing line in the file so that the -b option is activated. 


SEE ALSO 


DIAGNOSTICS 


BUGS 


esplit(1), tabs(1), fspec(4) 

All diagnostics are fatal. 

usage: ... newform was called with a bad option. 

not -s format There was no tab on one line. 

can’t open file Self-explanatory. 

internal line too long A line exceeds 512 characters after being expanded 
in the internal work buffer. 

tabspec in error A tab specification is incorrectly formatted, or speci- 


fied tab stops are not ascending. 


tabspec indirection illegal A tabspec read from a file (or standard input) may 
not contain a tabspec referencing another file (or 
standard input). 


0 -normal execution; 1 — for any error 


newform normally keeps track of physical characters only. However, for the 
-i and -o options, newform will keep track of backspaces in order to line up 
tabs in the appropriate logical columns. newform will not prompt the user if 
a tabspec is to be read from the standard input (by use of -i-- or -o--). 


If the -f option is used, the last -o option specified was -o--, and it was pre- 
ceded by either a -o~- or a -i--, the tab specification format line will be incor- 
rect. 
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NAME 


newfs — construct a new file system 


SYNOPSIS 


/etc/newfs [ -N ] [ [ -v ] [ options ] special 


DESCRIPTION 
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The operating system programs newfs and mkfs(1M) are the same program 
binary. newfs provides a friendly interface to create file systems on disks 
with a VTOC. special is the device special file on which the new filesystem is to 
be created, and may be specified with no pathname /dev/rdsk prefix. newfs 
consults the VTOC residing on the disk to determine the characteristics of the 
disk so it can calculate the appropriate parameters to use in constructing a 
file system on that disk. 


Note that if a VTOC is not present on the disk, newfs cannot create a filesys- 
tem on that disk. (Use mkvtoc(1M) to add a VTOC.) 


If the -v option is specified, newfs prints out parameters which could be sup- 
plied to the mkfs interface for making file systems. 


The —-N option causes the file system parameters to be printed out without 
really creating the file system. 


Note that newfs will not install any system bootstraps on the disk. To install 
a bootstrap, use the installboot(1M) command. 


newfs uses fsirand(1M) as a security precaution for file systems which are 
mounted over NFS. 


The following options define the general layout policies. 


-b blocksize 
The block size of the file system in bytes. The default is taken from 
the VTOC. 


-f frag_size 
The fragment size of the file system in bytes. The default is taken 
from the VTOC. 

-m free_space % 
The percentage of space reserved from normal users; the minimum 
free space threshold. The default is 10%. See tunefs(1M) for more 
information on setting this option. 


-a maxcontig 
The maximum number of contiguous blocks that will be laid out 
before forcing a rotational delay (see -d below). The default is 1. 
See tunefs(1M) for more information on setting this option. 


-d rotdelay 
The expected time (in milliseconds) to service a transfer completion 


interrupt and initiate a new transfer on the same disk. The default 
is 4 milliseconds. See tunefs(1M) for more information on setting 
this option. 

-e maxbpg 
Indicates the maximum number of blocks any single file can allo- 
cate from one cylinder group before it is forced to begin allocating 
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blocks from another cylinder group. The default is about one quar- 
ter of the total blocks in a cylinder group. See tunefs(1M) for more 
information on setting this option. 


-i number_of_bytes_per_inode 
This specifies the density of inodes in the file system. The default is 
to create an inode for each 2048 bytes of data space. If fewer inodes 
are desired, a larger number should be used; to create more inodes 
a smaller number should be given. Be sure to specify this option 
for small filesystems (less than one cylinder group) or the number 
of inodes created will be too large. 


-c #cylinders_per_group 
The number of cylinders per cylinder group in a file system. The 
default is 16. 


-8 size The size of the file system in sectors. The default is taken from the 
VTOC. 


The following options override the standard sizes for the disk geometry. Their 
default values are taken from the VTOC, or are coded internally to newfs. 
Changing these defaults is useful when using newfs to build a file system 
whose raw image will eventually be used on a different type of disk than the 
one on which it is initially created (for example on a write-once disk). 


-r revolutions_per_minute 
The speed of the disk in revolutions per minute. 


-S sector-size , 
The size of a sector in bytes (almost never anything but 512). 


-u sectors_per_track 
The number of sectors/track available for data allocation by the file 
system. This does not include sectors reserved at the end of each 
track for bad block replacement (see —p below). 


-t #ttracks_per_cylinder a 
The number of tracks/cylinder available for data allocation by the 
file system. 


-p spare_sectors_per_track 
Spare sectors (bad sector replacements) are physical sectors that 
occupy space at the end of each track. They are not counted as part 
of the sectors/track (-u) since they are not available to the file sys- 
tem for data allocation. 


-x spare_sectors_per_cylinder 
Spare sectors (bad sector replacements) are physical sectors that 
occupy space at the end of the last track in the cylinder. They are 
deducted from the sectors/track (—u) of the last track of each cylin- 
der since they are not available to the file system for data alloca- 
tion. 

-l hardware_sector_interleave 
Used to describe the media format to compensate for a slow control- 
ler. Interleave is physical sector interleave on each track, specified 
as the denominator of the ratio: 
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sectors read / sectors passed over 


Thus an interleave of 1/1 implies contiguous layout, while 1/2 
implies logical sector 0 is separated by one sector from logical sec- 
tor 1. 


-k skew Used to describe the media format to compensate for a slow control- 
ler. Track skew is the offset of sector 0 on track N relative to sector 
0 on track N-1 on the same cylinder. 
SEE ALSO 
devbuild(1M), fsck(1M), fsirand(1M), installboot(1M), mkfs(1M), mkvtoc(1M), 
prtvtoc(1M), tunefs(1M), fs(4) 
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NAME 


newerp — log in to a new group 


SYNOPSIS 


newgrp [-] [ group ] 


DESCRIPTION 


newerp changes a user’s group identification. The user remains logged in 
and the current directory is unchanged, but calculations of access permissions 
to files are performed with respect to the new real and effective group IDs. 
The user is always given a new shell, replacing the current shell, by newegrp, 
regardless of whether it terminated successfully or due to an error condition 
(i.e., unknown group). 


Exported variables retain their values after invoking newgrp; however, all 
unexported variables are either reset to their default value or set to null. Sys- 
tem variables (such as PS1, P82, PATH, MAIL, and HOME), unless exported by 
the system or explicitly exported by the user, are reset to default values. For 
example, a user has a primary prompt string (PS1) other than $ (default) and 
has not exported PSi. After an invocation of newgrp, successful or not, their 
P81 will now be set to the default prompt string $. Note that the shell com- 
mand export (see sh(1)) is the method to export variables so that they retain 
their assigned value when invoking new shells. 


With no arguments, newgrp changes the group identification back to the 
group specified in the user’s password file entry. This is a way to exit the 
effect of an earlier newgrp command. 


If the first argument to newgrp is a -, the environment is changed to what 
would be expected if the user actually logged in again as a member of the new 
group. 


A password is demanded if the group has a password and the user does not, or 


if the group has a password and the user is not listed in / etc/group as being a 
member of that group. 


FILES 
/etc/group System group file 
/etc/passwd System password file 
SEE ALSO 


BUGS 
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login(1), sh(1), group(4), passwd(4), environ(5) 


There is no convenient way to enter a password into /etc/group. Use of group 
passwords is not encouraged, because, by their very nature, they encourage 
poor security practices. Group passwords may disappear in the future. 
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NAME 
news — print news items 


SYNOPSIS 
news [ -a ][-n ] [-s ] [ items ] 


DESCRIPTION 
news is used to keep the user informed of current events. By convention, 
these events are described by files in the directory /usr/news. 


When invoked without arguments, news prints the contents of all current 
files in /usr/news , most recent first, with each preceded by an appropriate 
header. news stores the “currency” time as the modification date of a file 
named .news_time in the user’s home directory (the identity of this directory is 
determined by the environment variable $HOME). Only files more recent than 
this currency time are considered “current.” 


The options to the news command are as follows: 


-a Causes news to print all items, regardless of currency. In this case, 
the stored time is not changed. 


-n Causes news to report the names of the current items without print- 
ing their contents and without changing the stored time. 


-8 Causes news to report how many current items exist, without print- 
ing their names or contents, and without changing the stored time. It 
is useful to include such an invocation of news in one’s -profile file or 
in the system /etc/ profile. 


All other arguments are assumed to be specific news items that are to be 
printed. 


If the Delete key is typed during the printing of a news item, printing stops 
and the next item is started. Another Delete within one second of the first 
causes the program to terminate. 
FILES 
/etc/profile 
/usr/news/* 
$HOME/.news_time 
SEE ALSO 
profile(4), environ(5) 
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NAME 
nice — run a command at low priority 

SYNOPSIS 
nice [ -increment ] command [ arguments ] 

DESCRIPTION 
nice executes command with a lower CPU scheduling priority. If an incre- 
ment argument (in the range 1-19) is given, it is used. If not, an increment of 
10 is assumed. 


The superuser may run commands with priority higher than normal by using 
a negative increment such as ~-10. 
SEE ALSO 
nohup(1), sh(1), nice(2) 
DIAGNOSTICS 
nice returns the exit status of the subject command. 
BUGS 
An increment larger than 19 is equivalent to 19. 
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NAME 


nl — line numbering filter 


SYNOPSIS 


nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] 
[-wwidth] [-nformat] [-ddelim] file 


DESCRIPTION 
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nl reads lines from the named file (or from the standard input if no file is 
named) and reproduces the lines on the standard output. Lines are numbered 
on the left in accordance with the command options in effect. 


nl views the text it reads in terms of logical pages. Line numbering is reset at 
the start of each logical page. A logical page consists of a header, a body, and 
a footer section. Empty sections are valid. Different line numbering options 
are independently available for header, body, and footer (for example, no num- 
bering of header and footer lines while numbering blank lines only in the 
body). 


The start of logical page sections are signaled by input lines containing noth- 
ing but the following delimiter character(s): . 


Line contents Start of 


A\SAN: header 
\s\: body 
A footer 


Unless optioned otherwise, nl assumes the text being read is in a single logi- 
cal page body. 


Command options may appear in any order and may be intermingled with an 
optional filename. Only one file may be named. The options are as follows: 


-btype Specifies which logical page body lines are to be numbered. Recog- 
nized types and their meanings are as follows: 


a Number all lines 

t Number lines with printable text only 

n No line numbering 

pstring Number only lines containing the regular 


expression specified in string 


~htype Same as -btype except for header. Default type for logical page 
header is n (no lines numbered). Default type for logical page body 
is t (text lines numbered). 


-ftype Same as -btype except for footer. Default for logical page footer is 
n (no lines numbered). 


~vstart# start# is the initial value used to number logical page lines. 


Default is L 

~iiner incr is the increment value used to number logical page lines. 
Default is L 

-p Do not restart numbering at logical page delimiters. 
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num is the number of blank lines to be considered as one. For 
example, ~I2 results in only the second adjacent blank being num- 
bered (if the appropriate -ha, —ba, and/or —fa option is set). 
Default is L 

sep is the character(s) used in separating the line number and the 
corresponding text line. Default sep is a tab. 


width is the number of characters to be used for the line number. 
Default width is 6. 


format is the line numbering format. Recognized values are: In 
(eft justified, leading zeros suppressed), rn (right justified, leading 
zeros suppressed), rz (right justified, leading zeros kept). Default 
format is rn (right justified). 

The delimiter characters specifying the start of a logical page sec- 
tion may be changed from the default characters (\:) to two user- 
specified characters. If only one character is entered, the second 
character remains the default character (:). No space should 
appear between the -d and the delimiter characters. To enter a 
backslash, use two backslashes. 


The following command will number file] starting at line number 10 with an 
increment of 10. 


nl -v10 -i10-d!+ filel 


The logical page delimiters are !+. 


SEE ALSO 
pr(1) 
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NAME 
noage, nopff, noswap, onproc — run a command with priority aging, PFF, swap- 
ping, or processor migration disabled 

SYNOPSIS 
/etc/noage command [ arguments ] 


/ete/nopff command [ arguments ] 
/etc/noswap command [ arguments ] 
/etc/onproc proc command [ arguments ] 

DESCRIPTION 
noage executes command (and its children) with priority aging disabled. 
Ordinarily, process priority is an inverse function of the process’s CPU usage 
in the recent past. (See proc_ctl(2)). 
nopff executes command without the command (or its children) being sub- 
jected to PFF adjustments. PFF (Page Fault Frequency) adjustments are 
changes in the resident-set size based on the frequency of page faults. (See 
vm_ctl(2)). 
noswap executes command with swapping for the command (and its children) 
disabled. (See vm_ctl(2)). 
onproc executes command on processor number proc, with processor migra- 
tion disabled for the command (and its children). (See tmp_affinity(2)). 
These commands may be nested. For example, the following line executes 
mycommand with swapping, PFF-ing, and processor migration disabled. 
/etc/nopff /etc/noswap /etc/onproc 0 mycommand arg! arg2 
‘These commands are effective only when invoked by the superuser, unless the 
underlying system call option has been configured for non-superuser 


processes. See the proc_ctl(2) and vm_ctl(2) manual entries for configura- 
tion options. 


” SEE ALSO 


proc_ctl(2), tmp_affinity(2), vm_ctl(2) 
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NAME 

nohup — run a-command immune to hangups and quits 
SYNOPSIS 

nohup command [ arguments ] 
DESCRIPTION 


nohup executes command with hangups and quits ignored. If output is not 
re-directed by the user, both standard output and standard error are sent to 
nohup.out. If nohup.out is not writable in the current directory, output is 
redirected to $HOME/nohup.out. 


EXAMPLES 


It is frequently desirable to apply nohup to pipelines or lists of commands. 
This can be done only by placing pipelines and command lists in a single file, 
called a shell procedure. When you issue the following command, nohup 
applies to everything in file. 


nohup sh file 
If the shell procedure file is to be executed often, then the need to type sh can 


be eliminated by giving file execute permission. Add an ampersand and the 


contents of file are run in the background with interrupts also ignored (see 
sh(1)): 


nohup file & 
Following is an example of the contents of file: 
sort ofile > nfile 
SEE ALSO 
chmod(1), nice(1), sh(1), signal(2) 
WARNINGS 
In the following command, nohup applies only to commandl. 
nohup command]; command2 
The following command is syntactically incorrect. 


nohup (command1; command2) 
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NAME 


od — octal dump 


SYNOPSIS 


od [ -bedosx ] [ file ] [ [ + Joffset[ . | b] ] 


DESCRIPTION 
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od dumps file in one or more formats as selected by the first argument. If the 
first argument is missing, —-o is default. The meanings of the format options 
are as follows: 


-b Interpret bytes in octal. 


-c Interpret bytes in ASCII. Certain non-graphic characters appear as C 
escapes: null=\0, backspace=\b, form-feed=\f, newline=\n, return=\r, 
tab=\t; others appear as 3-digit octal numbers. 


Interpret words in unsigned decimal. 
Interpret words in octal. 
Interpret 16-bit words in signed decimal. 


aon 


-x Interpret words in hex. 


The file argument specifies which file is to be dumped. If no file argument is 
specified, the standard input is used. 


The offset argument specifies the offset in the file where dumping is to com- 
mence. This argument is normally interpreted as octal bytes. Ifa dot (.) is 
appended, the offset is interpreted in decimal. If b is appended, the offset is 
interpreted in blocks of 512 bytes. If the file argument is omitted, the offset 
argument must be preceded by +. 


Dumping continues until end-of-file. 
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NAME 


online, offline — bring processors online and offline 


SYNOPSIS 


/etc/online -N 
/etc/online -S 
/etc/online [ -a ] [ -v ] [ processor-number ... ] 
/etc/offline [ -a ] [ -v ] [ processor-number ... ] 


DESCRIPTION 


online —N causes the number of currently online processes to be printed. 
This is very useful in shell scripts. 


online -S causes a one line summary on the online processors to be printed. 
Also very useful in shell scripts. 


online causes the given processors to initialize and begin scheduling user 
processes. Processors are numbered consecutively upward from zero. If the 
-a option is present, all processors in the system are brought online. 


offline removes the given processor{s] from the pool of processors available for 
work. One processor is always left online. If the -a option is present, all but 
one of the processors in the system are brought offline. 


Both online and offline display which processors are on and offline. If the -v 
option is specified, any resulting changes in state (on or offline) are also 
displayed. 


Only the superuser can take processors on or offline. 


SEE ALSO 
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shutdown(1M), tmp_ctl(2), tmp_affinity(2) 
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NAME 


pack, peat, unpack — compress and expand files 


SYNOPSIS 


pack [-][-f] name... 
peat name... 


unpack name... 


DESCRIPTION 
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pack attempts to store the specified files in a compressed form. Wherever 
possible (and useful), each input file name is replaced by a packed file name.z 
with the same access modes, access and modified dates as those of name. The 
-f option will force packing of name. This is useful for causing an entire direc- 
tory to be packed even if some of the files will not benefit. If pack is success- 
ful, name will be removed. Packed files can be restored to their original form 
by using unpack or pcat. 


pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If 
the —- argument is used, an internal flag is set that causes the number of times 
each byte is used, its relative frequency, and the code for the byte to be printed 
on the standard output. Additional occurrences of -in place of name will 
cause the internal flag to be set and reset. 


The amount of compression obtained depends on the size of the input file and 
the character frequency distribution. Because a decoding tree forms the first 
part of each .z file, it is usually not worthwhile to pack files smaller than three 
blocks unless the character frequency distribution is very skewed, which may 
occur with printer plots or pictures. 


Typically, text files are reduced to 60-75% of their original size. Load modules, 
which use a larger character set and have a more uniform distribution of char- 
acters, show little compression, the packed versions being about 90% of the 
original size. 

pack returns a value that is the number of files that it failed to compress. 

No packing will occur if any of the following conditions exist: 


The file appears to be already packed; 

The file has links; 

The file is a directory; 

The file cannot be opened; 

No disk storage blocks will be saved by packing; 
A file called name.z already exists; 

The .z file cannot be created; 

An J/O error occurred during processing. 


Directories cannot be compressed. 


peat does for packed files what cat(1) does for ordinary files, except that peat 
cannot be used as a filter. The specified files are unpacked and written to the 
standard output. Thus, to view a packed file named name.z, you could use this 
command: 


peat name.z 
or just: 
peat name 
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To make an unpacked copy, say nnn, of a packed file named name.z (without 
destroying name.z) use this command: 


peat name >nnn 


peat returns the number of files it was unable to unpack. Failure may occur 
if any of these conditions exist: 


The file cannot be opened; 
The file does not appear to be the output of pack. 


Unpack expands files created by pack. For each file name specified in the 
command, a search is made for a file called name.z (or just name, if name ends 
in.z). If this file appears to be a packed file, it is replaced by its expanded ver- 
sion. The new file has the .z suffix stripped from its name and has the same 
access modes, access and modification dates as those of the packed file. 


unpack returns a value that is the number of files it was unable to unpack. 
Failure may occur for the same reasons that it may in peat, as well as for the 
following: 

A file with the “unpacked” name already exists; 

The unpacked file cannot be created. 


SEE ALSO 
cat(1) 
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NAME 


passmgmt — password files management 


SYNOPSIS 


passmgmt -a options name 
passmgmt -m options name 
passmgmt -d name 


DESCRIPTION 
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The passmgmt command updates information in the password files. This 
command works with both /etc/passwd and /etc/shadow. If there is no 
/etc/shadow, the changes done by passmgmt will go only to /etc/ passwd. 


passmgmt -a adds an entry for user name to the password files. This com- 
mand does not create any directory for the new user and the new login 
remains locked (with the string *LK* in the password field) until the 
passwd(1) command is executed to set the password. 


passmgmt —m modifies the entry for user name in the password files. The 
name field in the /etc/shadow entry and all fields (except the password field) 
in the /etc/passwd entry can be modified by this command. Only fields 
entered on the command line will be modified. 


passmgmt —d deletes the entry for user name from the password files. It will 
not remove any files that the user owns on the system; they must be removed 
manually. 


The following additional options are available: 

-c comment A short description of the login. It is limited to a maximum of 
128 characters and defaults to an empty field. 

-h homedir Home directory of name. It is limited to a maximum of 256 char- 
acters and defaults to /usr/name. 


-u uid UID of the name. This number must range from 0 to the maxi- 
mum non-negative value for the system. It defaults to the next 
available UID greater than 99. Without the —o option, it 
enforces the uniqueness of a UID. 


-o This option allows a UID to be non-unique. It is used only with 
the -u option. 
-ggid GID of the name. This number must range from 0 to the maxi- 


mum non-negative value for the system. The default is 1. 


-6 shell Login shell for name. It should be the full pathname of the pro- 
gram that will be executed when the user logs in. The maximum 
size of shell is 256 characters. The default value is for this field to 
be empty and to be interpreted as /bin/sh. 


-llogname This option changes the name to logname. It is used only with 
the -m option. 


-p passwd Encrypted password for name. This option inserts the already 
encrypted passwd string into the proper password file instead of 
the *LK* string. The passwd string should consist entirely of 
characters in the regular expression [./0-9A-Za-z] and must be 
exactly 13 characters long. This option should be used with 
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caution because there is no way to determine the corresponding 
string that must be entered by a user to achieve passwd. 


The total size of each login entry is limited to a maximum of 511 bytes in each 
of the password files. 


FILES 
/etc/passwd, /etc/shadow, /etc/opasswd, /etc/oshadow 
SEE ALSO 
passwd(1), passwd(4) 
DIAGNOSTICS 
The passmgmt command exits with one of the following values: 
0 Success. 
uf Permission denied. 
2 Invalid command syntax. Usage message of the passmgmt com- 
mand will be displayed. 
3 Invalid argument provided to option. 
4 UD in use. 
5 Inconsistent password files (for example, name is in the 


/etc/passwd file and not in the /etc/shadow file, or vice versa). 
Unexpected failure. Password files unchanged. 

Unexpected failure. Password file(s) missing. 

Password file(s) busy. Try again later. 


onnr an 


name does not exist (if -m or —d is specified), already exists (if -a is 
specified), or logname already exists (if -m -1 is specified). 


NOTES 
You cannot use a colon or <Return> as part of an argument because it will be 
interpreted as a field separator in the password file. 
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NAME 


passwd — change login password and password attributes 


SYNOPSIS 


passwd [ name J 
passwd [-1] | -d][-n min ][-f][ -x max ] name 
passwd -s [ -a ] 


passwd -s [ name ] 


DESCRIPTION 
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The passwd command changes a user’s password or lists password attributes 
associated with the user’s login name. Superusers can use passwd to install 
or change passwords and attributes associated with any login name. 


When used to change a password, passwd prompts ordinary users for their 
old password, if any. It then prompts for the new password twice. When the 
old password is entered, passwd checks to see if it has aged sufficiently. If 
aging is insufficient, passwd terminates; see passwd(4). 


Assuming aging is sufficient, a check is made to ensure that the new password 
meets construction requirements. When the new password is entered a sec- 
ond time, the two copies of the new password are compared. If the two copies 
are not identical, the cycle of prompting for the new password is repeated for 
at most two more times. 


Passwords must be constructed to meet the following requirements: 


Each password must have at least 6 characters. Only the first 8 char- 
acters are significant. 


Each password must contain at least 2 alphabetic characters and at 
least 1 numeric or special character. In this case, alphabetic refers to 
all upper- or lowercase letters. 


Each password must differ from the user’s login name and any reverse 
or circular shift of that login name. For comparison purposes, an 
uppercase letter and its corresponding lowercase letter are equivalent. 


New passwords must differ from the old by at least 3 characters. For 
comparison purposes, an uppercase letter and its corresponding lower- 
case letter are equivalent. 


Superusers (that is, real and effective uid equal to zero, see id(1M) and 
su(1M)) may change any password; hence, passwd does not prompt 
superusers for the old password. Superusers are not forced to comply with 
password aging and password construction requirements. A superuser can 
create a null password by entering a carriage return in response to the prompt 
for a new password. (This differs from passwd —d because the “password” 
prompt will still be displayed.) 

Any user can use the -s option to show password attributes for his or her own 
login name. The format of the display is as follows: 


name status mm/dd/yy min max 


If password aging information is not present, the display has this format: 


PASSWD(1) DYNIX/ptx 


name status 


The format has this meaning: 


name The login ID of the user. 


status The password status of name: PS stands for passworded or 
locked, LK stands for locked, and NP stands for no password. 


mm/dd/yy The date the password was last changed for name. (Note that all 
password aging dates are determined using Greenwich Mean 
Time and, therefore, may differ by as much as a day in other time 
zones.) 


min The minimum number of days required between password 
changes for name. 

max The maximum number of days the password is valid for name. 

Only a superuser can use the following options: 

-l Locks password entry for name. 


-d Deletes password for name. The login name will not be prompted 
for password. 


—n Set minimum field for name. The min field contains the minimum 
number of days between password changes for name. If min is 
greater than max, the user may not change the password. Always 
use this option with the -x option, unless max is set to -1 (aging 
turned off). In that case, min need not be set. 


-x Set maximum field for name. The max field contains the number of 
days that the password is valid for name. The aging for name will 
be turned off immediately if max is set to—1. If it is set to 0, then 
the user is forced to change the password at the next login session 
and aging is turned off. 


-a Show password attributes for all entries. Use only with -s option; 
name must not be provided. 
-f Force the user to change password at the next login by expiring the 
; password for name. 

FILES 

/etc/passwd, /etc/shadow, /etc/opasswd, /etc/oshadow 
SEE ALSO 

login(1), id(1M), passmgmt(1M), pwconv(1M), su(1M), crypt(3C), passwd(4) 
DIAGNOSTICS 


The passwd command exits with one of the following values: 
Success. 

Permission denied. 

Invalid combination of options. 

Unexpected failure. Password file unchanged. 


kr ON HF O 


Unexpected failure. Password file(s) missing. 
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5 Password file(s) busy. Try again later. 
@ 6 Invalid argument to option. 
WARNING 
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If the optional /etc/shadow file feature is used, the passwd(1) command will 
use that file, instead of the /etc/ passwd file, to obtain password information. 
Because password aging information is stored in the two files in a slightly dif- 
ferent manner, the output from passwd options that use this information 
may also be different. 
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NAME 
paste — merge same lines of several files or subsequent lines of one file 


SYNOPSIS 
paste filel file2 ... 
paste —dlist filel file2 ... 
paste -s [-dlist] filel file2 ... 


DESCRIPTION 
In the first two forms, paste concatenates corresponding lines of the given 
input files file1, file2, and so on. It treats each file as a column or columns of a 
table and pastes them together horizontally (parallel merging). It is the 
counterpart of cat(1), which concatenates vertically (one file after the other). 
In the last form above, paste replaces the function of an older command with 
the same name by combining subsequent lines of the input file (serial merg- 
ing). In all cases, lines are glued together with the Tab character or with 
characters from an optionally specified list. Output is to the standard output 
and can be used as the start of a pipe or as a filter, if -is used in place of a 
filename. 


The meanings of the options are as follows: 


-d Without this option, the newline characters of each but the last file (or 
last line in case of the -s option) are replaced by a Tab character. This 
option allows replacing the Tab character by one or more alternate 
characters (see below). 


list One or more characters immediately following -d replace the default 
tab as the line concatenation character. The list is used circularly; 
when exhausted, it is reused. In parallel merging (no -s option), the 
lines from the last file are always terminated with a newline charac- 
ter, not from the list. The list may contain these special escape 
sequences: \n (newline), \t (tab), \\ (backslash), and \0 (empty 
string, not a null character). Quoting may be necessary if characters 
have special meaning to the shell (for example, to get one backslash, 
use -d"\\\\"). 


-8 Merge subsequent lines rather than one from each input file. Use Tab 
for concatenation, unless a list is specified with the —d option. Regard- 
less of the list, the last character of the file is forced to be a newline. 


- May be used in place of any filename, to read a line from the standard 
input. (There is no prompting). 


EXAMPLES 
Is | paste -d"" - List directory in one column 
Is | paste - - -- List directory in four columns 
paste -s -d'\t\n" file Combine pairs of lines into lines 
SEE ALSO 
cut(1), grep(1), pr(1) 
DIAGNOSTICS . 
line too long Output lines are restricted to 511 characters. 
too many files Except for -s option, no more than 12 input files may be 


specified. 
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NAME 
© pathconv — search Interpreter criteria for filename 
SYNOPSIS 
pathconv [-v alias] [-f] [-t] 
DESCRIPTION 


The pathconv command is used to convert an alias to its pathname. It takes 
the alias as a string from stdin. The —-v option allows the alias to be embedded 
in the command string. The -t option implies that pathconv should expand 
the alias in a format suitable for display as a frame title. This format is a 
shortened version of the full pathname, created by deleting components of the 
path from the middle of the string until it is under 42 characters in length, 
and then inserting "..." between the remaining pieces. The -f option means 
return the full path (this is the default). 

EXAMPLES 
Here is a menu that is titled using pathconv: 


Mmenu=‘pathconv -t -v SARG1* 


This will result in the same thing: 
Menu=‘echo SARG1 | pathconv -t* 


SEE ALSO 
echo(1F) 
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NAME 


pg — file perusal filter for CRTs 


SYNOPSIS 


pg [-number] [-p string] [-cefns] [+linenumber] [+/pattern/] [files...] 


DESCRIPTION 
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The pg command is a filter that allows the examination of files one screenful 
at a time on a CRT. (The filename — and/or NULL arguments indicate that pg 
should read from the standard input.) Each screenful is followed by a prompt. 
If the user types a carriage return, another page is displayed; other possibili- 
ties are enumerated below. 


This command is different from previous paginators in that it allows you to 
back up and review something that has already passed. The method for doing 
this is explained below. 


In order to determine terminal attributes, pg scans the terminfo(4) database 
for the terminal type specified by the environment variable TERM. If this 
variable is not defined, the terminal type dumb is assumed. 


The command line options are as follows: 


-number An integer specifying the size (in lines) of the window that pg is to 
use instead of the default. (On a terminal containing 24 lines, the 
default window size is 23). 


-p string Causes pg to use string as the prompt. If the prompt string con- 
tains a “%d”, the first occurrence of “%d” in the prompt will be 
replaced by the current page number when the prompt is issued. 
The default prompt string is “:”. 

-c Home the cursor and clear the screen before displaying each page. 


This option is ignored if clear_screen is not defined for this ter- 
minal] type in the terminfo(4) database. 


-e Causes pg not to pause at the end of each file. 


-f Normally, pg splits lines longer than the screen width, but some 
sequences of characters in the text being displayed (such as escape 
sequences for underlining) generate undesirable results. The -f 
option inhibits pg from splitting lines. 


-n Normally, commands must be terminated by a newline character. 
This option causes an automatic end of command as soon asa 
command letter is entered. 


-8 Causes pg to print all messages and prompts in standout mode 
(usually inverse video). 

+linenumber 
Start up at linenumber. 

+/pattern/ Start up at the first line containing the regular expression pat- 
tern. 


The responses you can type when pg pauses can be divided into three 
categories: those causing further perusal, those that search, and those that 


modify the perusal environment. 
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Commands that cause further perusal normally take a preceding address, 
which is an optionally signed number indicating the point from which further 
text should be displayed. This address is interpreted in either pages or lines 
depending on the command. A signed address specifies a point relative to the 
current page or line; an unsigned address specifies an address relative to the 
beginning of the file. Each command has a default address that is used if none 
is provided. 

The perusal commands and their defaults are as follows: 


(+1) newline or blank 
This causes one page to be displayed. The address is specified in 
pages. 

(+1)1 With a relative address, this causes pg to simulate scrolling the 
screen forward or backward the number of lines specified. With an 
absolute address, this command prints a screenful beginning at the 
specified line. 


(+1) dor Ctrl-D 
Simulates scrolling half a screen forward or backward. 


The following perusal commands take no address. 


- or Ctrl-L 
Typing a single period causes the current page of text to be 
redisplayed. 

$ Displays the last windowful in the file. Use with caution when the 


input is a pipe. 
The following commands are available for searching for text patterns in the 
text. The regular expressions described in ed(1) are available. They must 
always be terminated by a newline, even if the —n option is specified. 


t/pattern/ 
Search forward for the ith (default i=1) occurrence of pattern. Search- 
ing begins immediately after the current page and continues to the 
end of the current file, without wrap-around. 


i’pattern” 

i2pattern? 
Search backwards for the ith (default i=1) occurrence of pattern. 
Searching begins immediately before the current page and continues 
to the beginning of the current file, without wrap-around. The * nota- 
tion is useful for Adds 100 terminals which will not properly handle 
the ?. 

After searching, pg will normally display the line found at the top of the 

screen. This can be modified by appending m or b to the search command to 

leave the line found in the middle or at the bottom of the window from now on. 

The suffix t can be used to restore the original situation. 

The user of pg can modify the environment of perusal with the following com- 

mands: 

in Begin perusing the ith next file in the command line. Thei is an 
unsigned number; the default value is 1. 
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ip Begin perusing the ith previous file in the command line. Zis an 
& unsigned number; the default is 1. 
iw Display another window of text. If iis present, set the window size to 
t 
8 filename 


Save the input in the named file. Only the current file being perused 
is saved. The white space between the s and filename is optional. This 
command must always be terminated by a newline, even if the —-n 
option is specified. 

h Help by displaying an abbreviated summary of available commands. 

qorQ Quit pg. 

Icommand 
Command is passed to the shell, whose name is taken from the SHELL 
environment variable. If this is not available, the default shell is used. 


This command must always be terminated by a new-line, even if the 
-n option is specified. 
At any time when output is being sent to the terminal, the user can hit the 
quit key (normally Ctrl-\) or the Interrupt (Break) key. This causes pg to stop 
sending output and display the prompt. The user can then enter one of the 
above commands in the normal manner. Unfortunately, some output is lost 
when this is done, due to the fact that any characters waiting in the terminal’s 
output queue are flushed when the quit signal occurs. 
) If the standard output is not a terminal, then Pg acts just like cat(1) except 
that a header is printed before each file (if there is more than one). 
EXAMPLES 
Following is a sample usage of pg in reading system news: 


news | pg -p "(Page %d):" 


FILES 
/usr/ib/terminfo/?/* Terminal information database 
/tmp/pg* Temporary file when input is from a pipe 
SEE ALSO 
ed(1), grep(1), terminfo(4) 
NOTES 


While waiting for terminal input, pg responds to Break, Delete, and “ by ter- 
minating execution. Between prompts, however, these signals interrupt pg’s 
current task and place the user in prompt mode. These should be used with 
caution when input is being read from a pipe, since an interrupt is likely to 
terminate the other commands in the pipeline. 


Users of Berkeley's more will find that the z and f commands are available, 
and that the terminal /, *, or ? may be omitted from the searching commands. 
BUGS 


If terminal tabs are not set every eight positions, undesirable results may 
occur. 
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When using pg as a filter with another command that changes the terminal 
Y/O options, terminal settings may not be restored correctly. i 
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NAME 


pmap — display or alter parameters of virtual-to-physical mapping devices 


SYNOPSIS 


/etc/pmap file [ paddr size [ type ] ] 


DESCRIPTION 


FILES 


file must be a character special file associated with the pmap device driver 
(see pmap(4)). pmap sets the parameters of the indicated file to those speci- 
fied (if any) and then displays all of the file’s parameters. 


The following parameters can be changed (only by the superuser, and only 
while the file is not in use): 


paddr The starting physical address of the region associated with the file. 
Must be hexadecimal and must be a multiple of the system page size, 
as returned by getpagesize(2). 

size The (hexadecimal) size of the region, in bytes. Must be hexadecimal 
and must be a multiple of the system page size. 


type Mustbe either npmem(non-paged memory) or phys (physical). The 
PMAP_NPMEM bit for this file is set or cleared as indicated. 


pmap also reports whether the file is currently mapped and whether it is cur- 
rently open for exclusive access. 


NOTE: This command allows the superuser to associate a file with any range 
of physical addesses, including MULTIBUS mapping registers, nonexistent 


memory, etc. Specifying incorrect values for paddr or size can lead to catastro- 
phic results. 


pmap files are application-specific 


SEE ALSO 


getpagesize(2), pmap(7) 


DIAGNOSTICS 
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“Not a typewriter” indicates that the specified file is not a pmap device. 
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NAME 
pr — print files 


SYNOPSIS . 
pr [[-column] [-wwidth] [-a]] [-eck] [-ick] [-drtfp] [ page] [-nck] 
[-ooffset] [-length] [-sseparator] [~hheader] [file ...] 


pr [[-m] [-wwidth]] [-eck] [-ick] [-drtfp] [ page] [-nck] [-ooffset] 
[-llength] [-sseparator] [-hheader] filel file2 ... 


DESCRIPTION 
pr is used to format and print the contents of a file. If file is — or if no files are 
specified, pr assumes standard input. pr prints the named files on standard 
output. 


By default, the listing is separated into pages, each headed by the page num- 
ber, the date and time the file was last modified, and the name of the file. 

Page length is 66 lines, which includes 10 lines-of header and trailer output. 
The header is composed of 2 blank lines, 1 line of text ( can be altered with 
-h), and 2 blank lines; the trailer is 5 blank lines. For single column output, 
line width may not be set and is unlimited. For multicolumn output, line 
width may be set and the default is 72 columns. Diagnostic reports (failed 
options) are reported at the end of standard output associated with a terminal, 
rather than interspersed in the output. Pages are separated by series of line 
feeds rather than form feed characters. 


By default, columns are of equal width, separated by at least one space; lines 
which do not fit are truncated. If the -s option is used, lines are not truncated 
and columns are separated by the separator character. 


Either -column or -m should be used to produce multi-column output. —a 
should be used only with -column, not with -m. 


Command line options are as follows: 
+page Begin printing with page numbered page (default is 1). 


-column Print column columns of output (default is 1). Output appears as 
if-e and -i are turned on for multi-column output. May not use 
with -m. 

-a Print multi-column output across the page one line per column. 


columns must be greater than one. Ifa line is too long to fitina 
column, it is truncated. 


-m Merge and print all files simultaneously, one per column. The 
maximum number of files that may be specified is eight. Ifa line 
is too long to fit in a column, it is truncated. May not use with 
-column. 


-d Double-space the output. Blank lines that result from double- 
spacing are dropped when they occur at the top of a page. 


-eck Expand input tabs to character positions k+1, 2*k+1, 3+k+1, etc. 
Ifk is 0 or is omitted, default tab settings at every eighth posi- 
tion are assumed. Tab characters in the input are expanded into 
the appropriate number of spaces. Ifc (any non-digit character) 
is given, it is treated as the input tab character (default for c is 
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-ick 


-nck 


-wwidth 


-ooffset 


-Vength 


-h header 


i 


-f 


-r 
-t 


~-sseparator 
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the tab character). 


In output, replace white space wherever possible by inserting 
tabs to character positions k+1, 2+k+1, 3*k+1, and so on. Ifk is 
0 or is omitted, default tab settings at every eighth position are 
assumed. Ifc (any non-digit character) is given, it is treated as 
the output tab character (default for c is the tab character). 


Provide k-digit line numbering (default for k is 5). The number 
occupies the first k+1 character positions of each column of single 
column output or each line of -m output. Ife (any non-digit 
character) is given, it is appended to the line number to separate 
it from whatever follows (default for c is a tab). 


Set the width of a line to width character positions (default is 
72). This is effective only for multi-column output (-column and 
-m). There is no line limit for single column output. 


Offset each line by offset character positions (default is 0). The 
number of character positions per line is the sum of the width 
and offset. 


Set the length of a page to length lines (default is 66). -10 is reset 
to -166. When the value of length is 10 or less, -t appears to be in 
effect since headers and trailers are suppressed. By default, out- 
put contains 5 lines of header and 5 lines of trailer leaving 56 
lines for user-supplied text. When -length is used and length 
exceeds 10, then length-10 lines are left per page for user sup- 
plied text. When length is 10 or less, header and trailer output is 
omitted to make room for user supplied text. 


Use header as the text line of the header to be printed instead of 
the filename. -h is ignored when -t is specified or -l/ength is 
specified and the value of length is 10 or less. (-h is the only pr 
option requiring space between the option and argument.) 
Pause before beginning each page if the output is directed toa 
terminal (pr will ring the bell at the terminal and wait for a car- 
riage return). 

Use single form-feed character for new pages (default is to use a 


sequence of line-feeds). Pause before beginning the first page if 
the standard output is associated with a terminal. 

Print no diagnostic reports on files that will not open. 

Print neither the five-line identifying header nor the five-line 
trailer normally supplied for each page. Quit printing after the 
last line of each file without spacing to the end of the page. Use 
of -t overrides the —h option. 

Separate columns by the single character separator instead of by 
the appropriate number of spaces (default for separator is a tab). 
Prevents truncation of lines on multicolumn output unless —-w is 
specified. 
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EXAMPLES 
Print file and file2 as a double-spaced, three-column listing headed by “file 
list”: 
pr -S3dh "file list” filel file2 
Copy file! to file2, expanding tabs to columns 10, 19, 28, 37, ...: 
pr -e9 -t <filel > file2 


Print file and file2 simultaneously in a two-column listing with no header or 
trailer where both columns have line numbers: 


pr -t -n filel | pr -t -m -n file2- 


FILES 
/devitty* If standard output is directed to one of the special files 
/dev/tty*, then other output directed to this terminal is 
delayed until standard output is completed. This prevents 
error messages from being interspersed throughout the output. 
SEE ALSO 
cat(1), pg(1) 
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NAME 


prof — display profile data 


SYNOPSIS 


prof [-tcan] [-ox] [-g] [-z] [-h] [-s] [-m mdata] [prog] 


DESCRIPTION 
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The prof command interprets a profile file produced by the monitor(3C) func- 
tion. The symbol table in the object file prog (a.out by default) is read and 
correlated with a profile file (mon.out by default). For each external text sym- 
bol, the percentage of time spent executing between the address of that sym- 
bol and the address of the next is printed, together with the number of times 
that function was called and the average number of milliseconds per call. 


The mutually exclusive options t, c, a, and n determine the type of sorting of 
the output lines: 


+t Sort by decreasing percentage of total time (default). 
-c Sort by decreasing number of calls. 

-a Sort by increasing symbol address. 

-n Sort lexically by symbol name. 


The mutually exclusive options o and x specify the printing of the address of 
each symbol monitored: 


-o Print each symbol address (in octal) along with the symbol name. 
-x Print each symbol address (in hexadecimal) along with the symbol 
name. 


The following options may be used in any combination: 
-g Include non-global symbols (static functions). 


4 Include all symbols in the profile range [see monitor(3C)], even if 
associated with zero number of calls and zero time. 


-h Suppress the heading normally printed on the report. (This is 
useful if the report is to be processed further.) 


-s Print a summary of several of the monitoring parameters and sta- 
tistics on the standard error output. 


-m mdata Use file mdata instead of mon.out as the input profile file. 


A program creates a profile file ifit has been loaded with the -p option of 
cc(1). This option to the ee command arranges for calls to monitor(3C) at 
the beginning and end of execution. It is the call to monitor at the end of 
execution that causes a profile file to be written. The number of calls toa 
function is tallied if the -p option was used when the file containing the func- 
tion was compiled. 


The name of the file created by a profiled program is controlled by the environ- 
ment variable PROFDIR. If this variable does not exist, mon.out is produced 
in the directory that is current when the program terminates. If PROFDIR = 
string, string / pid. progname is produced, where progname consists of argv[0] 
with any path prefix removed, and pid is the program’s process id. If PROF- 
DIR is the null string, no profiling output is produced. 
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A single function may be split into subfunctions for profiling by means of the 
MARK macro [see prof(5)].. , 


FILES 

mon.out For profile 

a.out For namelist 
SEE ALSO 

cc(1), exit(2), profil(2), monitor(3C), prof(5) 
WARNINGS 


The times reported in successive identical runs may show variances of 20% or 
more, because of varying cache-hit ratios due to sharing of the cache with 
other processes. Even if a program seems to be the only one using the 
machine, hidden background or asynchronous processes may blur the data. In 
rare cases, the clock ticks initiating recording of the program counter may 
“beat” with loops in a program, grossly distorting measurements. 


Call counts are always recorded precisely. 


The times for static functions are attributed to the preceding external text 
symbol if the -g option is not used. However, the call counts for the preceding 
function are still correct, (that is, the static function call counts are not added 
in with the call counts of the external function). 


NOTES 
Only programs that call exit(2) or return from main will cause a profile file to 
be produced, unless a final cal] to monitor is explicitly coded. 


The use of the -p option to cc(1) to invoke profiling imposes a limit of 600 
functions that may have call counters established during program execution. 
For more counters, you must call monitor(3C) directly. If this limit is 
exceeded, other data will be overwritten and the mon.out file will be cor- 
rupted. The number of call counters used will be reported automatically by 
the prof command whenever the number exceeds 5/6 of the maximum. 
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NAME 


PROMPT(1M) 


prompt — prompt program 


SYNOPSIS 


prompt [-T] command -- [options] 
DESCRIPTION 


The prompt 


program allows the user to initiate a command. The command’s 


form is displayed on the terminal screen and the cursor is positioned in the 
first input field. User responses are edited according to the specifications in 
the command description file. Help is available at both the option and com- 
mand level by pressing the HELP key. After all editing is complete, the com- 
mand is executed. 


T 


command 


options 


The command is run in trace mode. This option tells the prompt 
command to display the text generated according to the DISPLAY 
TEMPLATE in the command description. The command is not 
executed. You can use trace mode in vi (the text editor) to format 
commands. 


Name of the command description file that the prompt command 
uses. This is a compiled file created by the ec command com- 
piler. 


These options apply to the command called by the prompt com- 
mand. Use a double hyphen to separate the options from the com- 
mand name. The prompt command reads the command descrip- 
tion file and then applies the options to the command. The 
prompt command lets the user select options before the form is 
displayed on the screen. 


Environment Variables 


TFTERM 
TERM 
TERMINFO 


TFADMFILE 


Identifies the terminal type. 
If TFTERM is not set, this variable identifies the terminal type. 


Identifies an alternate location for the terminfo terminal 
descriptions. You do not need to define this environment vari- 
able since the directory $/TFADMFILE} / terminfo is used by 
default. 


Identifies the directory where the menu system administrative 
data files are located. This is used to locate the subdirectory 
edc, the default location of compiled files created by the ec 
command. 


TFEDCPATH Identifies directories that are alternate locations for the com- 


piled files created by the ec command. 


FILES 
$(TFADMFILE}{a-z/termtype Terminal definition file 
$(TFADMFILE)}/edccommand Compiled command description file 
SEE ALSO 
ec(1M), menu(1M) 
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NAME 
& prs — print an SCCS file 


SYNOPSIS 
prs [-d[dataspec]] [-r{SID]] [-e] [-1] [-c[date-time]] [-a] files 
DESCRIPTION 
prs prints, on the standard output, parts or all of an SCCS file [see scesfile(4)] 
in a user-supplied format. Ifa directory is named, prs behaves as though 
each file in the directory were specified as a named file, except that non-SCCS 
files (ast component of the pathname does not begin with s.), and unreadable 
files are silently ignored. If a name of —is given, the standard input is read. 
Each line of the standard input is taken to be the name of an SCCS file or 
directory to be processed; non-SCCS files and unreadable files are silently 
ignored. 


Arguments to prs, which may appear in any order, consist of keyletter argu- 
ments, and filenames. 


All the described keyletter arguments apply independently to each named file: 


-d{dataspec] Used to specify the output data specification. The dataspec is 
a string consisting of SCCS file data keywords (see Data Key- 
words) interspersed with optional user supplied text. 


-r{SID] Used to specify the SCCS identification (SID) string of a delta 
for which information is desired. If no SID is specified, the SID 
: of the most recently created delta is assumed. 


-e Requests information for all deltas created earlier than and 
including the delta designated via the -r keyletter or the date 
given by the -c option. 


-l Requests information for all deltas created later than and 
including the delta designated via the -r keyletter or the date 
given by the -c option. 


-c[date-time] The cutoff date-time -c[cutoff]] is in the form: 
YYTMM[DD[HH[MMI[SS]]}]] 
Units omitted from the date-time default to their maximum 
possible values. For example, -c7502 is equivalent to 
-c750228235958 Any number of non-numeric characters 


may separate the various 2-digit pieces of the cutoff date in 
the form "~c77/2/2 9:22:25". 


-a Requests printing of information for both removed (delta type 
= R) [see rmdel(1)] and existing (delta type = D) deltas. If the 
-a keyletter is not specified, information for existing deltas 
only is provided. 

Data Keywords ; 

Data keywords specify which parts of an SCCS file are to be retrieved and out- 

put. All parts of an SCCS file [see secsfile(4)] have an associated data key- 

word. There is no limit on the number of times a data keyword may appear in 

a dataspec. 
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appropriate values (extracted from the SCCS file) substituted for the recog- 
nized data keywords in the order of appearance in the dataspec. The format of 
a data keyword value is either Simple (S), in which keyword substitution is 
direct, or Multi-line (M), in which keyword substitution is followed by a car- 
riage return. 


The information printed by prs consists of: (1) the user-supplied text; and (2) ; 


User-supplied text is any text other than recognized data keywords. 


A tab is specified by \t and carriage return/newline is specified by \n. The 
default data keywords are as follows: 


":Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:" 


SCCS Files Data Keywords 
Key- Data Item File Section Value Format 
word 
Dt: Delta information Delta Table See below* Ss 
:DL: Delta line statistics ” :Liv/:Ld:/:Lu: Ss 
Li: Lines inserted by Delta : nnnnn s 
‘Ld: Lines deleted by Delta " nnnnn s 
sLu: Lines unchanged by Delta = nnnnn Ss 
:DT: Delta type . DorR Ss 
a: SCCS D string (SID) i :R:.:L:.:B:.:S: Ss 
:R: Release number = nnnn Ss 
iL: Level number ‘ nnnn Ss 
:B: Branch number e nnnn Ss 
S: Sequence number is nnan Ss 
:D: Date Delta created :Dy:/:Dm¢/:Dd: Ss 
:Dy: Year Delta created 7 nn Ss 
:Dm: Month Delta created . nn Ss 
:Dd: Day Delta created i nn a) 
iT: Time Delta created " :Th:::Tm:::Ts: Ss 
Th: Hour Delta created ‘i nn s 
:Tm: Minutes Delta created - nn s 
Ts: Seconds Delta created 7 nn Ss 
P: Programmer who created Delta logname iS} 
:DS: Delta sequence number i nnnn s 
:DP: Predecessor Delta seq-no. . nnnn Ss 
:DI: Sequence numbers of deltas ™ :Dnv/:Dxz/:Dg: Ss 
included, excluded, ignored 
:Dn: Deltas included (seq #) " :DS: :DS:... Ss 
:Dx: Deltas excluded (seq #) ~ :DS: :DS:... Ss 
:Dg: Deltas ignored (seq #) * :DS: :DS:... Ss 
:MR: MR numbers for delta = text M 


* Dt: = :DT: :I: :D: :T: :P: DS: DP: 
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SCCS Files Data Keywords (Cont.) 


Key- Dataltem File Section 
word 

:C: Comments for delta . 
:UN: User names User Names 
FL: Flag list Flags 

s¥Y: Module type flag " 
:MF: MR validation flag s 
:MP: MR validation pgm name . 
:KF: Keyword error/warning flag m 
‘KV: Keyword validation string i‘ 
‘BF: Branch flag e 

J: Joint edit flag ea 
‘LK: Locked releases " 

:Q: User-defined keyword i 

:*M: Module name “ 
‘FB: Floor boundary = 
:CB: Ceiling boundary " 

:Ds: Default SID " 
‘ND: Null delta flag ‘i 
‘FD: File descriptive text Comments 
‘BD: Body Body 
:GB: Gotten body = 

:W: =A form of what(1) string N/A 

:A: =A form of what(1) string N/A 

:Z: —_ what(1) string delimiter N/A 

‘F: SCCS filename N/A 
:PN: SCCS file pathname N/A 

EXAMPLES 


text 
Z:M:\t:I: 
2Zz:Y: Mz :]s:Zz 
@(#) 
text 
text 


prs ~d"Users and/or user IDs for :F: are:\n:UN:" s.file 
may produce on the standard output: 


Users and/or user IDs for s.file are: 


xyz 
131 
abc 


prs -d"Newest delta for pgm :M:: :I: Created :D: By :P:"-r s.file 
may produce on the standard output: 
Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 


Asa special case, prs 8-file may produce the following on the standard output 
for each delta table entry of the D type. 
D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 


MRS: 
b178-12345 
b179-54321 
COMMENTS : 


this is the comment line for s.file initial delta 
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PRS(1) 


Format 


NNNNNZSZRUANNRHAHANANHNNDHRAHRHSSS 


PRS(1) DYNIX/ptx 


The only keyletter argument allowed to be used with the special case is the -a 
keyletter. é S 


FILES 


SEE ALSO 
admin(1), delta(1), get(1), help(1), sccsfile(4) 


DIAGNOSTICS 
Use help(1) for explanations. 
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NAME 

prtvtoc — print the VTOC of a block device 
SYNOPSIS 

/etc/prtvtoc [ -s ] [ -h ] [-T ] [ -t fstab ] [-m mnttab ] device 
DESCRIPTION 


prtvtoc allows the contents of the VTOC (volume table of contents) to be 
viewed by a user for reference or verification. In addition to printing the con- 
tents of the VTOC, the command lists any free areas on the disk (that is, those 
without a partition). 


The device on which the VTOC is installed may be specified as a simple disk 
name such as zd0 or sd1 without any path prefix. If this form of disk is used, 
the appropriate path to a special device is generated automatically. Alterna- 
tively, the pathname to a character special device should be given. The char- 
acter special device may be a disk partition, the disk’s diagnostic device, or the 
prepartitioned disk device. (See vtoc(7)). 

The following options to prtvtoc can be used: 


-8 Print only the partition table, with headings but without the 
comments. This option also inhibits the printing of all 
V_NOPART partitions. 


-h Print only the partition table, without headings and comments. 
Use this option when the output of the prtvtoc command is 
piped into another command. 


T Print only the disk type name. Use this option to discover what 
the disk type is. 
-tfstab Use the file fstab instead of /etc/ fstab. 
-mmnttab Use the file mnttab instead of /etc/mnttab. 
EXAMPLE 
The command line entry and system response shown below are for a 
792-megabyte disk: 


# prtvtoc /dev/rdsk/zd1s0 <CR> 
* /dev/rdsk/zd1sO partition map 


* 


* Disk Type: m2333k 
* 

* Dimensions: 

x 512 bytes/sector 

i 66 sectors/track 

* 10 tracks/cylinder 

* 823 cylinders 


x, 
* Partition Types: 

* 0: Empty Slot 

* 1: Regular Partition 
* 

* 

* 


nN 


: Bootstrap Area 
: Reserved Area 
Firmware Area 


mW 
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Start Size BlockSz FragSz Mount 
* Type Sector in Sectors in Bytes in Bytes Point 
0 1 221100 49500 8192 1024 
1 HS 270600 67320 8192 1024 
2 1 337920 203940 8192 1024 
3 J, 692 220408 8192 1024 
4 0 ie) 0 8192 1024 
5 0 0 ie} 8192 1024 
6 0 0 ie} 8192 1024 
7 0 (¢) 0 8192 1024 
8 0 0 0 8192 1024 
9 0 0 0 8192 1024 
10 O 0 0 8192 1024 
11 0 0 t¢) 8192 1024 
12 3 0 660 0 0 
13 3 541860 1320 0 0 
14° 2 660 16 0 (o} 
15 #3 676 16 0 0) 
# 


Codes for TYPE are as follows: 


Name Number 
No Partition 0 
Regular Partition 1 
Boot Area 2 
Reserved Area 3 
Firmware Area 4 


If the device passed to prtvtoc does not contain a VTOC, an error will occur. 


SEE ALSO 
mkvtoc(1M) 


NOTES 
If a diagnostic device is provided to prtvtoc (i.e., a device of the form 
/ dev / diag /rdsk /xx?), then mountpoints will not be listed. 


Only users belonging to group sys can use this command. 
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NAME 


ps — report process status 


SYNOPSIS 


ps [options] 


DESCRIPTION 


ps prints certain information about active processes. Without options, infor- 
mation is printed about processes associated with the controlling terminal. 
The output consists of a short listing containing only the process ID, terminal 
identifier, cumulative execution time, and the command name. Otherwise, the 
information that is displayed is controlled by the selection of options. 


Options accept names or lists as arguments. Arguments can be either 
separated from one another by commas or enclosed in double quotes and 
separated from one another by commas or spaces. Values for proclist and 
grplist must be numeric. 


The options are given in descending order according to volume and range of 
information provided: 


-e Print information about every process now running. 

-d Print information about all processes except process group lead- 
ers. 

-a Print information about all processes most frequently requested: 
all those except process group leaders and processes not associ- 
ated with a terminal. 

-f Generate a full listing. (See below for significance of columns in 
a full listing.) 

-F Generate an even fuller listing. (See below for significance of col- 
umns in a fuller listing.) : 

- Generate a long listing. (See below.) 


-nname Valid only for users with a real user ID of root or a real group ID 


of sys. Takes argument signifying an alternate system name in 
place of /unix. 


-ttermlist List only process data associated with the terminal given in term- 
list. Terminal identifiers may be specified in one of two forms: 
the device filename (such as ttyGA/GAAB) or, if the device 
filename starts with tty, just the digit identifier (such as 
GA/GAAB). 


-p proclist List only process data whose process ID numbers are given in 
proclist. 


-uuidlist List only process data whose user ID number or login name is 
given in uidlist. In the listing, the numerical user ID will be 
printed unless you give the -f or -F option, which prints the 
login name. 


-ggrplist List only process data whose process group leader ID number(s) 
appears in grplist. (A group leader is a process whose process ID 
number is identical to its process group ID number. A login shell 
is a common example of a process group leader.) 


PS(1) 


DYNIX/ptx 


arguments given when the process was created by examining the user block. 
Failing this, the command name is printed as it would have appeared without 
the -f or -F options, in square brackets. 


The column headings and the meaning of the columns in a ps listing are given 
below. The letters f, F and l indicate the option (full, fuller or long, respec- 
tively) that causes the corresponding heading to appear; all means that the 
heading always appears. Note that these two options determine only what 
information is provided for a process. They do not determine which processes 
will be listed. 


Fq) Flags (hexadecimal and additive) associated with the pro- 
cess: 
00 Process has terminated; process table entry now 
available. 
01 Asystem process; always in primary memory. 
02 Parent is tracing process. 
04 Tracing parent’s signal has stopped process; parent is 
waiting [ptrace(2)]. 
08 Process is currently in primary memory. 
10 Process currently in primary memory; locked until 
an event completes. 
8) The state of the process: 
Process is running on a processor. 
Sleeping; process is waiting for an event to complete. 
Runable; process is on run queue. 
Idle; process is being created. 
Zombie state; process terminated and parent not 
waiting. 
Traced; process stopped by a signal because parent is 
tracing it. 
SXBRK state; process is waiting for more primary 
memory. 
UD (f,1) The user ID number of the process owner (the login name is 
printed under the -f option). 
PID (all) The process ID of the process (this datum is necessary in 
order to kill a process). 


PPID (f,1) The process ID of the parent process. 

Ci) Processor utilization for scheduling. 

PRI (1) The priority of the process (higher numbers mean lower pri- 
ority). 

NI (1) Nice value, used in priority computation. 

ADDR (1) The memory address of the process. 

8Z (1) The size (in K) of the swappable process’s image in main 
memory. 


Rss (F) The real memory (resident set) size of the process (in K) or, if 
the process is swapped, the resident set size when the 


Under the -f or -F options, ps tries to determine the command name and ; 


~ BH NMDWHO 
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FILES 


process was swapped out. 


ENG (F) The processor number on which a runnable process is run- 
ning (blank if the process is not running). 

WCHAN (1) The address of an event for which the process is sleeping or 
in SXBRK state (if blank, the process is running). 

STIME (f) The starting time of the process, given in hours, minutes, 


and seconds. (A process begun more than 24 hours before 
the ps inquiry is executed is given in months and days.) 


TTY (all) The controlling terminal for the process (the message ? 
prints when there is no controlling terminal). 
TIME (all) The cumulative execution time for the process. 


COMMAND (all) The command name (the full command name and its argu- 
ments are printed under the -f option). 


A process that has exited and has a parent, but has not yet been waited for by 
the parent, is marked <defunct>. 


/dev 

/devitty* 

/dev/kmem Kernel virtual memory 
/dev/swap The default swap device 
/dev/mem Memory 


/etc/passwd UID information supplier 
/etc/ps_data Internal data structure 
/unix System namelist 


SEE ALSO 


kill(1), nice(1), getty(1M) 


_ WASSIN GS 


Things can change while ps is running; the snap-shot it gives is only true for a 
split-second, and it may not be accurate by the time you see it. Some data 
printed for defunct processes is irrelevant. 


If no termlist, proclist, uidlist, or grplist is specified, ps checks stdin, stdout, 
and stderr in that order, looking for the controlling terminal, and attempts to 
report on processes associated with the controlling terminal. In this situation, 
if stdin, stdout, and stderr are all redirected, ps will not find a controlling ter- 
minal, so there will be no report. 


On a heavily loaded system, ps may report an Iseek(2) error and exit. ps may 
seek to an invalid user area address: having obtained the address of a process’ 
user area, ps may not be able to seek to that address before the process exits 
and the address becomes invalid. 


ps -ef may not report the actual start ofa tty login session, but rather an ear- 
lier time, when a getty was last respawned on the tty line. 


If the user specifies the -n flag, the real and effective UID/GID will be set to 
the real UID/GID of the user invoking ps. 


DYNIX/ptx , PWCK(1M) 


NAME 
pwek, grpck — password/group file checkers 


SYNOPSIS . 
/ete/pwek [file] 
/ete/grpck [file] 

DESCRIPTION 
pwek scans the password file and notes any inconsistencies. The checks 
include validation of the number of fields, login name, user ID, group ID, and 
whether the login directory and the program-to-use-as-Shell exist. The 
default password file is /etc/passwd. The /etc/passwd file contains the fol- 
lowing entries that have names longer than 8 characters: checkfsys, 
mountsys, powerdown, and umountfsys. Only the first 8 characters are signif- 
icant, therefore pwck generates warning messages because these names are 
longer than 8 characters. You can ignore these messages. 


erpek verifies all entries in the group file. This verification includes a check 
of the number of fields, group name, group ID, and whether all login names 
appear in the password file. The default group file is /etc/group. If a group 
contains no users, the error message Null login name is generated. The 
operating system is distributed with the group other which has no users and causes 
this message to be generated. You can ignore the message. 

FILES 
/etc/group 
etc/passwd 

SEE ALSO 
group(4), passwd(4) 

DIAGNOSTICS 
Group entries in /etc/group with no login names are flagged. 

NOTES 
The standard password file, /etc/ passwd, contains the following entries that 
have names longer than 8 characters: checkfsys, mountfsys, powerdown, and 
umountfsys. Only the first 8 characters are significant in any name. pwck 
generates warnings because these names exceed 8 characters. You can ignore 
the warnings. 
By default, the operating system includes a group called other containing no 


users. If group contains no users, grpcek generates the warning message 
Null login name. You can ignore the message. 
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NAME 
pweonv — installs and updates /ete/shadow with information from 
/etc/ passwd 
SYNOPSIS 
pwconv 
DESCRIPTION 
The pwconv command creates and updates /etc/shadow with information 
from /ete/ passwd. 


If the /etc/shadow file does not exist, this command will create /etc/shadow 
with information from /etc/passwd. The command populates /etc/ shadow 
with the user’s login name, password, and password aging information. If 
password aging information does not exist in /etc/ passwd for a given user, 
none will be added to /etc/shadow. However, the “last changed” information 
will always be updated. 


If the /etc/ shadow file does exist, the following tasks will be performed: 


Entries that are in the /etc/ passwd file and not in the /etc/shadow 
file will be added to the /etc/shadow file. 


Entries that are in the /etc/shadow file and not in the /etc/ passwd 
file will be removed from /etc/shadow. 


Password attributes (for example, password and aging information) 
that exist in an /etc/passwd entry will be moved to the corresponding 
entry in /etc/shadow. 


The pwconv program is a privileged system command that cannot be exe- 
cuted by ordinary users. 


FILES 

/etc/passwd, /etc/shadow, /etc/opasswd, /etc/oshadow 
SEE ALSO 

passwd(1), passmgmt(1M), pwunconv(1M) 
DIAGNOSTICS . 

The pweonv command exits with one of the following values: 
Success. 
Permission denied. 
Invalid command syntax. 
Unexpected failure. Conversion not done. 
Unexpected failure. Password file(s) missing. 
Password file(s) busy. Try again later. 


ark ON & OS 
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NAME 
pwd — working directory name 
SYNOPSIS 
pwd 
DESCRIPTION 
pwd prints the pathname of the working (current) directory. 
SEE ALSO 
ed(1) 


DIAGNOSTICS 
Cannot open ..and Read error in .. indicate possible filesystem trou- 
ble and should be referred to a system administrator. 
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NAME 


pwdhd — daemon to oversee password database creation 


SYNOPSIS 


pwdhd 


DESCRIPTION 


FILES 


The pwdhd program is intended to be run as a daemon that is started by the 
init process. This is accomplished by an entry in the /etc/inittab file. 


The program will create the FIFO (named pipe) /etc/pwdp if it does not exist. 
The program then checks for the existence of the password databases. If they 
do not exist, the program /etc/mkpwdbm is run as a child process to create 
them. 


Next, the program reads from the FIFO looking for the characters r, p, and s. 
These characters cause /etc/mkpwdbm to rebuild the password database 
files. A p specifies the database file for /etc/ passwd is to be built, an s speci- 
fies the database file for /etc/ shadow is to be built, and an r indicates that 
both files are to be built. 


The pwdhd program is intended to be invoked only by init. It must execute 
as the superuser to be able to run the program /etc/mkpwdbm. 


/etc/mkpwdbm 
letc/pwdp 
/etc/passwd 
/etc/passwd_dbm.dir 
/etc/passwd_dbm.pag 
/etc/shadow 
/etc/shadow_dbm.dir 
/etc/shadow_dbm.pag 


SEE ALSO 
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NAME 


pwfix — remove incorrectly formatted password entries 


SYNOPSIS 


pwfix [ -fqv ] 


DESCRIPTON 


FILES 


The pwfix command scans the password file /etc/passwd, and optionally 
/etc/ shadow, allowing any incorrectly formatted entries to be deleted. pwfix 
should be run when an error is reported by one of the programs which manip- 
ulates the password files. 


pwfix uses fgetpwent(3C) and fgetspent(3C) to read the password file (and 
shadow file) entries one at a time and copy them to a temporary file. If these 
routines cannot parse an entry, the entry is an error and must be deleted or 
corrected. After completing a scan of the file, the temporary file is renamed to 
the original. 


By default the program runs interactively. Ifa bad entry is encountered, it is 
displayed and the user prompted with a question asking if the line should be 
deleted. A response of y deletes the entry, n keeps the line, and q terminates 
the scan of the file. A count of the deleted lines is provided. If no lines are 
deleted, there is no output. 


The -f option forces deletion of bad lines. If -f is specified, pwfix lists the 
lines which were deleted and a count of the lines deleted. If no lines are 
deleted, there is no output. 


The -q option is used to suppress summary information. It is normally com- 
bined with -f when the command is used in a shell script. 


The -v option is used to force summary information. 
This command may be used only by the super user. 


This program allows recovery of damaged password files. Deleted lines can be 
replaced by using system administration tools. Hand editing must be done 
only with great care and is not recommended. 


/etc/passwd 
/etc/shadow 
/etc/opasswd 
/etc/oshadow 


SEE ALSO 


passmgmt(1M), passwd(1M), pweonv(1M), pwunconv(1M), passwd(4) 


DIAGNOSTICS 
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The pwfix command exits with one of the following values: 


0 - Success, no files changed 
1- No permission 

2 - Lock file busy 

3 - Incorrect command syntax 
4 - File error occurred 

5 - Success, files were changed 


DYNIX/ptx '  PWUNCONV(1M) 


NAME 
pwunconv — converts from a two to a one password file scheme © 


SYNOPSIS . 
pwunconv 


DESCRIPTION 
pwunconv converts the operating system from a two password file scheme 
(/etc/ passwd and / etc/shadow) to a one password file scheme (/etc/ passwd). 
It updates /etc/passwd with password information from /etc/shadow. If aging 
information is present in /etc/shadow, the password aging information in 
/etc/ passwd is also updated. 


The total size of a login entry for the password file is limited to a maximum of 
511 bytes. 


FILES 
/etc/passwd, /etc/shadow, /etc/opasswd, /etc/oshadow 


SEE ALSO 
passwd(1M), passmgmt{1M), pwconv(1M) 


DIAGNOSTICS 
The pwunconv command exits with one of the following values: 


Success. 

Permission denied. 

Invalid command syntax. 

Unexpected failure. Conversion not done. 
Unexpected failure. Password file missing. 
Password file(s) busy. Try again later. 
Shadow password file does not exist. 


Naa kh ® ND & OS 


Entry for name too long. Conversion not done. 
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NAME 
& . quota — display disk usage and limits 


SYNOPSIS 
quota [ -v ] [ user ] 


DESCRIPTION 
The quota command displays users’ disk usage and limits. Only the superuser 
can use the optional user argument to view the limits of other users. 


When the quota command is issued without options, it displays warnings only 


about mounted filesystems where usage is over quota. Remotely mounted 
filesystems that are mounted with the noquota option (see fstab(4)) are 


ignored. 

The following option is available: 

-v Display user’s quotas on all mounted filesystems where quotas exist 
FILES 

quotas Quota file at the filesystem root 

/etc/mnttab List of currently mounted filesystems 
SEE ALSO 


edquota(1M), quotaon(1M), quotactl(2seq), fstab(4) 
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NAME 


quotacheck — filesystem quota consistency checker 


SYNOPSIS 


/usr/etc/quotacheck [ -v ] [ -p ] filesystem... 
/usr/ete/quotacheck [ -v ][ -p ] -a 


DESCRIPTION 


quotacheck examines each filesystem, builds a table of current disk usage, 
and compares this table against that stored in the disk quota file for the 
filesystem. If any inconsistencies are detected, both the quota file and the cur- 
rent system copy of the incorrect quotas are updated. (The latter occurs only 
if an active filesystem is checked). 


quotacheck expects each filesystem to be checked to have a quota file named 
quotas in the root directory. If none is present, quotacheck ignores the 
filesystem. 


quotacheck is normally run at boot time from the 
/ete/rc2.d/SOIMOUNTFSYS file (see re2(1M)) before disk quotas are 
enabled with quotaon(1M). 


. quotacheck accesses the raw device in calculating the actual disk usage for 


each user. Thus, the filesystems checked should be quiescent while quota- 
check is running. 


The following options are available: 


~v Indicate the calculated disk quotas for each user on a particular 
filesystem. quotacheck normally reports only those quotas modi- 
fied. 
-a Check all the filesystems whose entries in /etc/fstab indicate they 
allow read-write access and have disk quotas. 
-p Run parallel passes on the required filesystems, using the pass num- 
bers in /etc/fstab in the same way they are used with fsck(1M). 
FILES 
/etc/fstab Default filesystems 
SEE ALSO 


quotaon(1M), quotactl(2seq) 
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NAME 


quotaon, quotaoff — turn filesystem quotas on and off 


SYNOPSIS 


‘usr/etc/quotaon [ -v ] filesystem... 
/usr/etc/quotaon [ -v ] -a 
/usr/etc/quotaoff [ -v ] filesystem... 
/usr/etc/quotaoff [ -v ] -a 


DESCRIPTION 


quotaon announces to the system that disk quotas should be enabled on one 
or more filesystems. The filesystems specified must have entries in /etc/fstab 
and must be mounted at the time. The filesystem quota files must be present 
in the root directory of the specified filesystem and must be named quotas. 
The optional -v argument causes quotaon to print a message for each filesys- 
tem that has quotas turned on. If quotaon has an -a argument instead of a 
list of filesystems, quotas are turned on for all filesystems whose entries in 
/etc/fetab indicate that they allow read-write access and have quotas. This 
option is normally used to enable quotas at boot time. 


quotaoff announces to the system that the specified filesystems should have 
any disk quotas turned off. As above, the -v option forces a verbose message 
for each filesystem affected, and the -a option disables quotas for all filesys- 
tems listed in /etc/fstab. 


These commands update the status field of devices located in /etc/mnttab to 
indicate when quotas are on or off for each filesystem. 


FILES 
/etc/mnttab Mount table 
/etc/fstab Filesystem table 
SEE ALSO 


12/89 


edquota(1M), quotactl(2SEQ), fstab(4), mnttab(4) 
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NAME 
ratfor — rational Fortran dialect 


SYNOPSIS 
ratfor [ options ] [ files ] 


DESCRIPTION 
ratfor converts a dialect of FORTRAN into ordinary FORTRAN. ratfor pro- 
vides control flow constructs essentially identical to those in C: 
statement grouping: 
{ statement; statement; statement } 
decision-making: 
if (condition) statement [ else statement ] 
switch (integer value) { 
case integer: statement 


[ default: J statement 


loops: 
while (condition) statement 
for (expression; condition; expression) statement 
do limits statement 
repeat statement [ until (condition) ] 
break 
next 


and some syntactic sugar to make programs easier to read and write: 


free form input: 

multiple statements/line; automatic continuation 
comments: 

# this is a comment. 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return expression to caller from function: 
return (expression) 
define: 
define name replacemént 
include: 
include file 


The option —h causes quoted strings to be turned into 27H constructs. The -C 
option copies comments to the output and attempts to format it neatly. Nor- 
mally, continuation lines are marked with a & in column 1; the option -6x 
makes the continuation character x and places it in column 6. 


ratfor is best used with £77(1). 


SEE ALSO 
efl(1), £77(1) 
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NAME 


rc0 —run commands performed to stop the operating system 


SYNOPSIS 


lete/rc0 


DESCRIPTION 


FILES 


This file is executed at each system state change that needs to have the sys- 
tem in an inactive state. It is responsible for those actions that bring the sys- 
tem to a state where it is safe to remove power, traditionally called shutdown. 


There are three system states that require this procedure. They are state 0 
(the system halt state), state 5 (the firmware state), and state 6 (the reboot 

state). Whenever a change to one of these states occurs, the /etc/rc0 proce- 
dure is run. The entry in /etc/inittab might read as follows: 


s0:056:wait:/etc/rc0 >/dev/console 2>&1 </dev/console 


Some of the actions performed by /etc/rc0 are carried out by files in the direc- 
tory /etc/shutdown.d and files beginning with Kin /etc/rc0.d. These files are 
executed in ASCII order (see FILES below for more information), terminating 
some system service. The combination of commands in /ete/rc0 and files in 
/ete/shutdown.d and /etc/rc0.d determine how the system is shut down. 


The recommended sequence for /ete/rc0 is as follows: 


Stop System Services and Daemons. 


Various system services (such as the LP Spooler) are gracefully ter- 
minated. 


When new services are added that should be terminated when the sys- 
tem is shut down, the appropriate files are installed in /etc/shut- 
down.d and /etc/rc0.d. 

Terminate Processes 
SIGTERM signals are sent to all running processes by killall(1M). 
Processes stop themselves cleanly if sent SIGTERM. 

Kill Processes 


SIGKILL signals are sent to all remaining processes; no process can 
resist SIGKILL. 


At this point the only processes left are those associated with lete/rc0 

and processes 0 and 1, which are special to the operating system. 
Unmount All Filesystems 

Only the root filesystem (/) remains mounted. 


Depending on which system state the systems end up in (0, 5, or 6), the entries 
in /etc/inittab direct what happens next. If /etc/inittab has not defined any 
other actions to be performed, as in the case of system state 0, the operating 
system will have nothing to do. It should not be possible to get the system’s 
attention. The only thing that can be done is to turn off the power or possibly 
get the attention ofa firmware monitor. The shutdown command can be 
used only by the superuser. 


The execution by /bin/sh of any files in /etc/shutdown.d occurs in ascii sort- 
sequence order. See re2(1M) for more information. 
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SEE ALSO 
killall(1M), re2(1M), shutdown(1M), re(4) 
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NAME 


re2 —run commands performed for multi-user environment 


SYNOPSIS 


lete/re2 


DESCRIPTION 
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This file is executed by an entry in /etc/inittab and initializes the system to a 
ready-to-use state, traditionally state 2, called the multiuser state. 


The actions performed by /ete/re2 are found in files in the directory /etc/re.d 
and files beginning with S in /etc/rc2.d. These files are executed by /bin/sh 
in ASCII sort-sequence order (see FILES for more information). 


You can create custom files (shell scripts) for your system in the directory 
/etc/rc2.d. If, during initialization to multi-user state, any problem is 
encountered that would make it detrimental to enter multiuser state, the cus- 
tom file could create a file called .single_user in the directory /etc/rc2.d. The 
file can contain text to explain the failure in more detail, and its contents can 
be displayed when the system is returned to single-user mode. 


For example, this mechanism is currently used by MOUNTFSYS in /ete/rc2. 
If problems are encountered during filesystem mounting, the message Going 
back to SINGLE USER mode! is issued, the contents of .single_user are 
displayed, and the system is returned to single-user mode. The following code 
is part of the MOUNTFSYS routine: 


# If the .single_user file gets created, it will contain 
# the reason to avoid going multi-user. Send init the 

# SINGLE_USER signal, print out the reason for going back 
# to single user mode and exit. Init cannot proceed with 
# the run-level change until this script exits. 


/bin/rm -f£ /etc/rc2.d/.single_user 
if [ -d /etc/rc2.d ] 


then 
for f in /etc/rce2.d/S* 
{ 
Af { —-S S{£) J 
then 
/bin/sh ${f} start 
status=$? 
if [ -f£ /etc/rce2.d/.single_user ] 
then 
/etc/init S 
echo '*** Going back to SINGLE 
USER mode!’ 
/bin/cat /etc/rc2.d/.single_user 
exit Sstatus 
fi 
fi 
} 
fi 
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The functions done by the /ete/re2 command and associated /etc/rc2.d files 
include the following: ; 


Setting and exporting the TIMEZONE variable. 

Setting-up and mounting the user (/usr) filesystem. 

Cleaning up the /tmp and /usr/tmp directories. 

Starting the cron daemon by executing /etc/cron. 

Cleaning up (deleting) uucp locks status and temporary files in the 

/usr/spool/uucp directory. 
Other functions can be added, as required, to support the addition of hardware 
and software features. 


EXAMPLES 


FILES 


The following are prototypical files found in /etc/rc2.d. These files are pre- 
fixed by an S and a number indicating the execution order of the files. 


RMTMPFILES 
# clean up /tmp 
rm -rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 
uucp 
# clean-up uucp locks, status, and temporary files 
xm -rf /usr/spool/locks/* 


The file /etc/ TIMEZONE is included early in /etc/rc2 , thus establishing the 
default time zone for all commands that follow. 


Here are some hints about files in /ete/re.d: 


The order in which files are executed is important. Since they are executed in 
ASCII sort-sequence order, using the first character of the filename as a 
sequence indicator helps keep the proper order. Thus, files starting with the 
following characters would be: 


[0-9]. very early 


[A-Z]. early 
[a-n]. later 
[o-z]. last 


Files in /etc/re.d that begin with a dot (.) are not executed. This feature can 
be used to hide files that are not to be executed for the time being without 
removing them. The command can be used only by the superuser. 


Files in /etc/rc2.d must begin with an S or a K followed by a two-digit 
sequence number and the rest of the filename. Upon entering run level 2, files 
beginning with S are executed with the start option; files beginning with K 
are executed with the stop option. Files beginning with other characters are 
ignored. 
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SEE ALSO 
© re0(1M), shutdown(1M), re(4) 
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NAME 


RCS(1) 


res — change RCS file attributes 


SYNOPSIS 


res [ options ] file ... 


DESCRIPTION 


res creates new RCS files or changes attributes of existing ones. An RCS file 
contains multiple revisions of text, an access list, a change log, descriptive 
text, and some control attributes. For res to work, the caller’s login name 
must be on the access list; if the access list is empty, the caller must be the 
owner of the file or the superuser, or the -i option must be present. 


Files ending in ,v are RCS files, all others are working files. Ifa working file is 
given, res tries to find the corresponding RCS file first in directory ./RCS and 
then in the current directory, as explained in co(1). 


-i 


-alogins 
~Aoldfile 


-e[logins] 


-cestring 


-I[rev] 


-u[rev] 


-L 
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Creates and initializes a new RCS file, but does not deposit any 
revision. If the RCS file has no path prefix, res tries to place it 
first into the subdirectory ./RCS, and then into the current 
directory. If the RCS file already exists, an error message is 
printed. 


Appends the login names appearing in the comma-separated 
list logins to the access list of the RCS file. 


Appends the access list of oldfile to the access list of the RCS 
file. 


Erases the login names appearing in the comma-separated list 
logins from the access list of the RCS file. If logins is omitted, 
the entire access list is erased. 


Sets the comment leader to string. The comment leader is 
printed before every log message line generated by the key- 
word $Log$ during checkout (see co). This is useful for pro- 
gramming languages without multi-line comments. During 
res -i or initial ci, the comment leader is guessed from the suf- 
fix of the working file. . 


Locks the revision with number rev. Ifa branch is given, the 
latest revision on that branch is locked. If rev is omitted, the 
latest revision on the trunk is locked. Locking prevents over- 


lapping changes. A lock is removed with ci or res —-u (see 
below). 


Unlocks the revision with number rev. If a branch is given, the 
latest revision on that branch is unlocked. If rev is omitted, 
the latest lock held by the caller is removed. Normally, only 
the locker of a revision may unlock it. Somebody else unlock- 
ing a revision breaks the lock. This causes a mail message to 
be sent to the original locker. The message contains a com- 
mentary solicited from the breaker. The commentary is ter- 
minated with a line containing a single dot (.) or Ctrl-D. 


Sets locking to strict. Strict locking means that the owner of an 
RCS file is not exempt from locking for check-in. This option 
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FILES 


U 


—nname[:rev] 


-Nname[:rev] 


-orange 


-q 
-sstate[:rev] 


-t[txtfile] 
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should be used for files that are shared. 


Sets locking to non-strict. Non-strict locking means that the 
owner of a file need not lock a revision for checkin. This option 
should NOT be used for files that are shared. The default (-L 
or -U) is determined by your system administrator. 


Associates the symbolic name name with the branch or revi- 
sion rev. res prints an error message if name is already associ- 
ated with another number. If rev is omitted, the symbolic 
name is deleted. 


Same as -n, except that it overrides a previous assignment of 
name. 


Deletes (outdates) the revisions given by range. A range con- 
sisting of a single revision number means that revision. A 
range consisting of a branch number means the latest revision 
on that branch. A range of the form rev]-rev2 means revisions 
rev1 to rev2 on the same branch, -rev means from the begin- 
ning of the branch containing rev up to and including rev, and 
rev— means from revision rev to the end of the branch contain- 
ing rev. Outdated revisions may not have branches or locks. 


Quiet mode; diagnostics are not printed. 


Sets the state attribute of the revision rev to state. If rev is 
omitted, the latest revision on the trunk is assumed. Ifrevisa 
branch number, the latest revision on that branch is assumed. 
Any identifier is acceptable for state. A useful set of states is 
Exp (for experimental), Stab (for stable), and Rel (for released). 
By default, ci sets the state of a revision to Exp. 


Writes descriptive text into the RCS file (deletes the existing 
text). If txtfile is omitted, res prompts the user for text sup- 
plied from the standard input, terminated with a line contain- 
ing a single ‘” or Ctrl-D. Otherwise, the descriptive text is 
copied from the file txtfile. If the -i option is present, descrip- 
tive text is requested even if -t is not given. The prompt is 
suppressed if the standard input is not a terminal. 


The caller of the command must have read/write permission for the directory 
containing the RCS file and read permission for the RCS file itself. res cre- 
ates a semaphore file in the same directory as the RCS file to prevent simulta- 
neous update. For changes, res always creates a new file. On successful com- 
pletion, res deletes the old one and renames the new one. This strategy 
makes links to RCS files useless. 


SEE ALSO 
co(1), ci(1), ident(1), resdiff(1), resintro(1), resmerge(1), rlog(1), sccstores(1), 


resfile(4) 


DIAGNOSTICS 
The RCS filename and the revisions outdated are written to the diagnostic 
output. The exit status always refers to the last RCS file operated on and is 0 
if the operation was successful, 1 otherwise. 
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@ NAME 


resdiff — compare RCS revisions 


SYNOPSIS . 


resdiff [ -biwt ] [ -cefhn J [ -rrev1 ] [ -rrev2 ] file ... 


DESCRIPTION 


resdiff runs diff(1) to compare two revisions of each RCS file given. A 
filename ending in ,v is an RCS filename, otherwise a working filename. 
resdiff derives the working filename from the RCS filename and vice versa, as 
explained in co(1). Pairs consisting of both an RCS and a working filename 
may also be specified. 


All options except -r have the same effect as described in diff(1). 


If both rev] and rev2 are omitted, resdiff compares the latest revision on the 
trunk with the contents of the corresponding working file. This is useful for 
determining what you changed since the last check-in. 


If rev1 is given but rev2 is omitted, resdiff compares revision rev1 of the RCS 
file with the contents of the corresponding working file. 


If both rev] and rev2 are given, resdiff compares revisions rev] and rev2 of 
the RCS file. 


Both revd and rev2 may be given numerically or symbolically. 


EXAMPLES 


The following command runs diff on the latest trunk revision of RCS file fc,v 
and the contents of working file fc. 


resdiff f.c 


SEE ALSO 


NOTES 
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ci(1), co(1), diff{1), ident(1), res(1), resintro(1), resmerge(1), rlog(1), resfile(4) 


Copyright 1982 by Walter F. Tichy. 
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NAME 
& rcesintro - introduction to RCS commands 


DESCRIPTION 
The Revision Control System (RCS) manages multiple revisions of text files. 
RCS automates the storing, retrieval, logging, identification, and merging of 
revisions. RCS is useful for text that is revised frequently, for example pro- 
grams, documentation, graphics, papers, form letters, and so on. 


The basic user interface is extremely simple. The novice needs to learn only 
two commands: ci(1) and co(1). ci, short for “check in,” deposits the contents 
of a text file into an archival file called an RCS file. An RCS file contains all 
revisions of a particular text file. co, short for “check out,” retrieves revisions 
from an RCS file. 


Functions of RCS 
¢ Storage and retrieval of multiple revisions of text. RCS saves all old revi- 
sions in a space efficient way. Changes no longer destroy the original, 
because the previous revisions remain accessible. Revisions can be 
retrieved according to ranges of revision numbers, symbolic names, dates, 
authors, and states. 


¢ Maintenance of a complete history of changes. RCS logs all changes auto- 
matically. Besides the text of each revision, RCS stores the author, the 
date and time of check-in, and a log message summarizing the change. 
The logging makes it easy to find out what happened to a module, without 
© having to compare source listings or having to track down colleagues. 


¢ Resolution of access conflicts. When two or more programmers wish to 
modify the same revision, RCS alerts the programmers and prevents one 
modification from corrupting the other. 


¢ Maintenance of a tree of Revisions. RCS can maintain separate lines of 
development for each module. It stores a tree structure that represents 
the ancestral relationships among revisions. 


¢ Merging of revisions and resolution of conflicts. Two separate lines of 
development of a module can be coalesced by merging. If the revisions to 
be merged affect the same sections of code, RCS alerts the user about the 
overlapping changes. 


¢ Release and configuration control. Revisions can be assigned symbolic 
names and marked as released, stable, experimental, and so on. With 
these facilities, configurations of modules can be described simply and 
directly. 

¢ Automatic identification of each revision with name, revision number, 
creation time, author, etc. The identification is like a stamp that can be 
embedded at an appropriate place in the text of a revision. The identifica- 
tion makes it simple to determine which revisions of which modules make 
up a given configuration. 

e¢ Minimization of secondary storage. RCS needs little extra space for the 
revisions (only the differences). If intermediate revisions are deleted, the 

‘ @ corresponding deltas are compressed accordingly. 
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Getting Started with RCS 
Suppose you have a file fc that you wish to put under control of RCS. Invoke 
the check-in command: 


ci fic 


This command creates the RCS file fc,v, stores fc in it as revision 1.1, and 
deletes fc. It also asks you for a description. The description should be a syn- 
opsis of the contents of the file. All later check-in commands will ask you for a 
log entry, which should summarize the changes that you made. 


Files ending in ,v are called RCS files (v stands for versions), the others are 
called working files. To get back the working file fc in the previous example, 
use the check-out command: 


co f.c 


This command extracts the latest revision from f-c,v and writes it into fc. You 
can now edit fc and check it back in by invoking this command: 


ci fic 


ci increments the revision number properly. If ci complains with the following 
message, then your system administrator has decided to create all RCS files 
with the locking attribute set to strict. 


ci error: no lock set by <your login> 


In this case, you should have locked the revision during the previous check- 
out. Your last check-out should have been as follows: 


co -1 f.c 


Of course, it is too late now to do the check-out with locking, because you prob- 
ably modified fc already, and a second check-out would overwrite your modifi- 
cations. Instead, invoke the following: 


res -l f.c 


This command will lock the latest revision for you, unless somebody else got 
ahead of you already. In this case, youl] have to negotiate with that person. 


Locking assures that you, and only you, can check in the next update, and 
avoids nasty problems if several people work on the same file. Even if a revi- 
sion is locked, it can still be checked out for reading, compiling, etc. Al] that 
locking prevents is a check-in by anybody but the locker. 


If your RCS file is private, i.e., if you are the only person who is going to 
deposit revisions into it, strict locking is not needed and you can turn it off. If 
strict locking is turned off, the owner of the RCS file need not have a lock for 
check-in; all others still do. Turning strict locking off and on is done with 
these commands: 


res -U fic and res -L f.c 


If you don’t want to clutter your working directory with RCS files, create a 
subdirectory called RCS in your working directory and move all your RCS files 
there. RCS commands will look first in that directory to find needed files. All 
the commands discussed above will still work, without any modification. 
(Actually, pairs of RCS and working files can be specified in three ways: (a) 
both are given, (b) only the working file is given, (c) only the RCS file is given. 
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Both RCS and working files may have arbitrary path prefixes; RCS commands 
pair them up intelligently). 


To avoid the deletion of the working file during check-in (in case you want to 
continue editing), invoke the following command: 


ei -lf.c or ci -u fic 


These commands check in fc as usual, but perform an implicit check-out. The 
first form also locks the checked in revision, the second one doesn’t. Thus, 
these options save you one check-out operation. The first form is useful if lock- 
ing is strict, the second one if not strict. Both update the identification mark- 
ers in your working file (see below). 


You can give ci the number you want assigned to a checked in revision. 
Assume all your revisions were numbered 1.1, 1.2, 1.3, etc., and you would like 
to start release 2. The following command assigns the number 2.1 to the new 
revision. 


ei -r2 fic or ci -r2.1 fic 


From then on, ci will number the subsequent revisions with 2.2, 2.3, and so 
on. The corresponding co commands retrieve the latest revision numbered 2.x 
and the revision 2.1, respectively. 


co -r2 fic and co -r2.1 f.c 


co without a revision number selects the latest revision on the “trunk” (i.e., 
the highest revision with a number consisting of 2 fields). Numbers with more 
than 2 fields are needed for branches. For example, to start a branch at revi- 
sion 1.3, invoke this command: 


ei -r1.3.1 fic 


This command starts a branch numbered 1 at revision 1.3 and assigns the 


number 1.3.1.1 to the new revision. For more information about branches, see 
resfile(4). 


Automatic Identification 
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RCS can put special strings for identification into your source and object code. 
To obtain such identification, place the following marker into your text, for 
instance inside a comment. 

$Header$ 
RCS will replace this marker with a string of this form: 


$Header: filename revision_number date time author state $ 


With such a marker on the first page of each module, you can always see with 
which revision you are working. RCS keeps the markers up to date automati- 
cally. To propagate the markers into your object code, simply put them into 
literal character strings. In C, this is done as follows: 


#ident "$Header$” 


The command ident extracts such markers from any file, even object code and 
dumps. Thus, ident lets you find out which revisions of which modules were 
used in a given program. 


You may also find it useful to put the marker $Log$ into your text, inside a 
comment. This marker accumulates the log messages that are requested 
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directly inside it. There are several additional identification markers; see 
co(1) for details. 
SEE ALSO 
ci(1), co(1), ident(1), merge(1), res(1), resdiff(1), resmerge(1), rlog(1) 
NOTES 
Copyright 1982 by Walter F. Tichy. 


during check-in. Thus, you can maintain the complete history of your file @ 
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NAME 

resmerge — merge RCS revisions . 
SYNOPSIS 

resmerge -rrev1 [ -rrev2 ] [ -p ] file 
DESCRIPTION 


resmerge incorporates the changes between rev and rev2 of an RCS file into 
the corresponding working file. If -p is given, the result is printed on the 
standard output, otherwise the result overwrites the working file. 

A filename ending in ,v is an RCS filename, otherwise a working filename. 
merge derives the working filename from the RCS filename and vice versa, as 
explained in co(1). A pair consisting of both an RCS and a working filename 
may also be specified. 


rev] may not be omitted. If rev2 is omitted, the latest revision on the default 
branch (normally the highest branch on the trunk) is assumed. Both revJ and 
rev2 may be given numerically or symbolically. 


resmerge prints a warning if there are overlaps, and delimits the overlapping 
regions as explained in co -j. The command is useful for incorporating 
changes into a checked-out revision. 


EXAMPLES 
Suppose you have released revision 2.8 of fc. Assume furthermore that you 
just completed revision 3.4, when you receive updates to release 2.8 from 
someone else. To combine the updates to 2.8 and your changes between 2.8 
and 3.4, put the updates to 2.8 into file fc and execute the following command: 


resmerge -p -r2.8 -r3.4 f.c >f.merged.c 


Then examine f.merged.c. Alternatively, if you want to save the updates to 
2.8 in the RCS file, check them in as revision 2.8.1.1 and execute co -j: 
ci -r2.8.1.1 f.c 
co -r3.4 -j2.8:2.8.1.1 f.c 
As another example, the following command undos the changes between revi- 
sion 2.4 and 2.8 in your currently checked out revision in fe. 
resmerge -r2.8 -r2.4 f.c 
Note the order of the arguments, and that fe will be overwritten. 
SEE ALSO 
ci(1), co(1), merge(1), ident(1), res(1), resdiff{1), rlog(1) 
NOTES 
Copyright 1982 by Walter F. Tichy. 
BUGS 
resmerge does not work on files containing lines with a single ‘’. 
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NAME 
readfile, longline — reads file and gets longest line 
SYNOPSIS 
readfile file 
longline [file] 
DESCRIPTION 
The readfile command reads the file named in its argument. No translation 
of newlines is done. It keeps track of the longest line it reads and if there isa 
subsequent call to longline, the length of that line, including the newline 
character, is returned. The longline command can be given an argument 
instead, in which case it returns the longest line of the argument file. 
EXAMPLES 
Here is a typical use of readfile and longline in a text object: 


text="‘readfile myfile‘" 
columns=‘longline* 


DIAGNOSTICS 


If the file does not exist, readfile will return FALSE (that is, the expression 
will have an error return). 


SEE ALSO 
cat(1) 
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NAME 


regcmp — regular expression compile 


SYNOPSIS 


regemp [ - ] files 


DESCRIPTION 


The regemp command performs a function similar to regemp(3X) and, in 
most cases, precludes the need for calling regemp(3X) from C programs. This 
saves on both execution time and program size. The command regemp com- 
piles the regular expressions in file and places the output in file.i. If the — 
option is used, the output will be placed in file.c. The format of entries in file 
is a name (C variable) followed by one or more blanks followed by a regular 
expression enclosed in double quotes. The output of regemp is C source code. 
Compiled regular expressions are represented as extern char vectors. file.i 
files may thus be included in C programs, or file.c files may be compiled and 
later loaded. In the C program which uses the regemp output, 
regex(abc,line) will apply the regular expression named abc to line. Diag- 
nostics are self-explanatory. 


EXAMPLES 


name "([A-Za—z][A—Za—z0-9_]*)$0" 


telno § "\({0,1}([2-9][01][1-9})$0\){0,1) +” 
“({2-9}[0—9]{2})$1[ -](0,1)" 
“((0-9]{4})$2" 


In the C program that uses the regemp output, the following line will apply 
the regular expression named telno to line. 


regex(telno, line, area, exch, rest) 


SEE ALSO 
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@ NAME 


regex — match patterns against a string 


SYNOPSIS 


| regex [-e] [pattern template]...pattern [template] 
regex [-e] -v “string” [pattern template]...pattern [template] 


DESCRIPTION 


The regex command takes a string (from stdin, or supplied with -v) and a list 
of pattern /template pairs, and runs regex(3X) on the string against each of 
the patterns until there is a match. When a match occurs, it writes the corre- 
sponding template to stdout and returns TRUE. The last (or only) pattern does 
not need a template. If the last or only pattern matches the string, the func- 
tion returns TRUE. If no match is found, regex returns FALSE. 


The -e option tells the function to evaluate the corresponding template and 
write the result to stdout. 


The patterns are regular expressions of the form described in regex(3X). In 
most cases, the pattern should be enclosed in single quotes to turn off special 
meanings of characters. 


The template may contain the strings $m0 through $mQ, which are expanded 
to the part of the pattern enclosed in ( ... }$0 through ( ... )$9 constructs (see 
examples below). Note that if you use this feature, you must be sure to 
enclose the template in single quotes so that the Interpreter doesn’t expand 
the $m0 through $m9 variables at parse time. This feature gives regex much 
of the power of cut(1), paste(1), and grep(1),and some of the capabilities of 
sed(1). If there is no template, the default is as follows: 


“$m0$m1$m2$m3$m4$m5$m6$m7$m8$m9" 
Note that only the final pattern may lack a template. 


EXAMPLES 
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To cut the 4th through 8th letters out of a string: 
‘regex -v "my string is nice" ’*.{3}(.{5})$0’ “Sm0’* 
In a form, for validating input as an integer: 
valid=‘regex -v "SF5" '*[0-9]+S' * 
In a form, to translate an environment variable that contains one of the num- 
bers 1, 2, 3, 4, 5 to the letters a, b, c, d, e: 
value=‘regex -v "SVAR1I" la2b3c4da5e%.** 
‘Error’ * 
Note the use of the pattern *.*” to mean anything else. 


In the example below, all three lines constitute a single backquoted expres- 
sion. This expression, by itself, could be put in a menu descriptor file. Since 
backquoted expressions are expanded as they are parsed and output from a 
backquoted expression (the cat command, in this example) becomes part of 
the descriptor file being parsed, this expression would read /etc/passwd and 
make a virtual menu of all the login ids on the system. 


‘cat /etc/passwd | regex ‘~([7:]*)$0.*S" ’ name=$m0 
action=‘message "$m0 is a user"*’* 
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SEE ALSO 


cut(1), grep(1), paste(1), sed(1), regemp(3) 


DIAGNOSTICS 


If none of the patterns match, regex returns FALSE, otherwise TRUE. 


WARNINGS 


BUGS 


Patterns and templates must usually be enclosed in single quotes to turn off 
the special meanings of characters, especially if you use the $m0 through $m9 
variables in the template, since the Interpreter expands the variables (usually 
to") before regex even sees them. 


The regular expressions accepted by regemp differ slightly from other utilities 
such as sed, grep, awk, and ed. 


Regex with the -e option forces subsequent commands to be ignored. In other 
words, if a backquoted statement appears as 


‘regex -e ...; commandl; command2* 


command] and command2 would never be executed. However, dividing the 
expression into two, as shown below, would yield the desired result. 


‘regex -e ...‘‘commandl; command2* 
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NAME 
reinit — run an initialization file 
SYNOPSIS 
reinit init_file 
DESCRIPTION 
The reinit command takes an initialization file name as its only argument. 
The Interpreter will parse and execute this file and then continue running the 


current application. reinit is typically used to change the defaults set by the 
initialization file that was named when fmli was invoked. 


The reinit command does not re-display the introductory object or change the 
Screen-labeled Keys layout. 
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NAME 


repquota — summarize quotas for a filesystem 


SYNOPSIS 


/usr/etc/repquota [ -v ] filesystem... 
/usr/etc/repquota [ -v ] -a 


DESCRIPTION 


repquota displays a summary of the disk usage and quotas for the specified 
filesystems. It shows the current number of files and the amount of space (in 
kilobytes) for each user, along with any quotas created with edquota(1M). 


The ability of users to view other user’s quotas, is determined by the protec- 
tion of the quotas file, at the root of each filesystem. Normally, the protection 
of this file is set so that only the superuser can view another user’s quotas. 


The following options are available: 


-a Report on all filesystems whose entries in /etc/fstab indicate that 
they allow read-write access and have quotas. 


-v Include all users having quotas, even if they are not using space. 
FILES 

quotas At the root of each filesystem with quotas 

/etc/fatab Has filesystem names and locations 
SEE ALSO 


edquota(1M), quota(1), quotacheck(1M), quotaon(1M), quotactl(2seq) 


DIAGNOSTICS 
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Various self-explanatory messages about inaccessible files 


DYNIX/ptx RESET(1F) 


NAME 
reset — reset the current form field to its default values 


SYNOPSIS 
reset 


DESCRIPTION 
The reset command resets a field in a form to its default value — the value 
displayed when the form was first opened. 
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NAME 

restore — incremental filesystem restore 
SYNOPSIS 

/etc/restore key [ name ... ] 
DESCRIPTION 


restore reads tapes dumped with the dump(1M) command. Its actions are 
controlled by the key argument. The key is a string of characters containing at 
most one function letter and possibly one or more function modifiers. Other 
arguments to the command are file or directory names specifying the files that 
are to be restored. Unless the h key is specified (see below), the appearance of 
a directory name refers to the files and (recursively) subdirectories of that 
directory. 


The function portion of the key is specified by one of the following letters: 


r The tape is read and loaded into the current directory. This should not 
be done lightly; the r key should only be used to restore a complete dump 
tape onto a clear filesystem or to restore an incremental dump tape after 
a full level zero restore. Thus, the following is a typical sequence to 
restore a complete dump. 

/etc/newfs /dev/rdsk/zd0s3 
/etc/mount /dev/rdsk/zd0s3 /mnt 
cd /mnt 

restore r 


Another restore can be done to get an incremental dump in on top of 
this. Note that restore leaves a file restoresymtab in the root directory 
to pass information between incremental restore passes. This file should 
be removed when the last incremental tape has been restored. 


A dump(1M) followed by a mkvtoc(1M), a newfs(1M), and a restore is 
used to change the size of a filesystem. 


R__ restore requests a particular tape of a multi-volume set on which to res- 
tart a full restore (see the r key above). This allows restore to be inter- 
rupted and then restarted. 


x The named files are extracted from the tape. If the named file matches a 
directory whose contents were written onto the tape and the h key is not 
specified, the directory is recursively extracted. The owner, modification 
time, and mode are restored (if possible). If no file argument is given, the 
root directory is extracted, which results in the entire contents of the 
tape being extracted (unless the h key was specified). 


t The names of the specified files are listed if they occur on the tape. Ifno 
file argument is given, the root directory is listed, which results in the 
entire contents of the tape being listed (unless the h key was specified). 


This mode allows interactive restoration of files from a dump tape. After 
reading in the directory information from the tape, restore provides a 
shell-like interface that allows the user to move around the directory 
tree selecting files to be extracted. The available commands are given 
below; for those commands that require an argument, the default is the 
current directory. 


be 
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Is [arg] — List the current or specified directory. Entries that are direc- 
tories are appended with a slash (/). Entries that have been 
marked for extraction are prepended with a asterisk (*). If the ver- 
bose key is set, the inode number of each entry is also listed. 


ed arg — Change the current working directory to the specified argu- 
ment. 


pwd — Print the full pathname of the current working directory. 


add [arg] — The current directory or specified argument is added to the 
list of files to be extracted. Ifa directory is specified, then it and all 
its descendents are added to the extraction list (unless the h key is 
specified on the command line). Files that are on the extraction list 
are prepended with an asterisk (*) when they are listed by ls. 


delete [arg] — The current directory or specified argument is deleted 
from the list of files to be extracted. Ifa directory is specified, then 
it and all its descendents are deleted from the extraction list 
(unless the h key is specified on the command line). The most expe- 
dient way to extract most of the files from a directory is to add the 
directory to the extraction list and then delete those files that are 
not needed. 


extract — All the files that are on the extraction list are extracted from 
the dump tape. restore will ask which volume the user wishes to 
mount. The fastest way to extract a few files is to start with the 
last volume and work towards the first volume. 


verbose — The sense of the v key is toggled. When set, the verbose key 
causes the ls command to list the inode numbers of all entries. It 
also causes restore to print out information about each file as it is 
extracted. 


help — List a summary of the available commands. 


quit — restore immediately exits, even if the extraction list is not 
empty. 


The following characters may be used in addition to the letter that selects the 
function desired. 


v 


f 


Normally restore does its work silently. The v (verbose) key causes it to 
print the name of each file it treats preceded by its file type. 


The next argument to restore is used as the name of the archive instead 
of /dev/rmt/xtOh. If the name of the file is “—”, restore reads from stan- 
dard input. Thus, dump(1M) and restore can be used in a pipeline to 
dump and restore a filesystem with this command: 
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dump Of—/usr | (cd /mnt; restore xf —) 


y restore will not ask whether it should abort the restore if gets a tape 


error. It will always try to skip over the bad tape block(s) and continue 
as best it can. 


m restore will extract by inode numbers rather than by filename. This is 
useful if only a few files are being extracted and you want to avoid regen- 
erating the complete pathname to the file. 


h restore extracts the actual directory, rather than the files that it refer- 
ences. This prevents hierarchical restoration of complete subtrees from 
the tape. 


8 The next argument to restore designates the number of files to skip 
from the beginning of the tape before using that tape for processing. 
This allows multiple (short) dumps to reside on a single tape, separated 
by logical EOF marks. If not given, restore begins processing with the 
first information right after the physical BOT label. 


b The next argument to restore designates the blocksize (in 1024 byte 
units) to read the tape. This option is useful when performing restores 
where tape is an actual file in the filesystem or a streamer tape where 
the interface acts like a block interface. restore attempts to intuit the 
blocksize by looking at the return from the first read of the tape. 
dump(1M) writes NIREC block records (currently 10) to normal density 
tapes unless given a different blocksize with the b option. Higher den- 
sity tapes (such as 6250 bpi) are written with HIGHDENSITYTREC block 
records (currently 32). 


Note: DYNIX (version 3.0 or earlier) conditional symbolic links on the dump 
tape are restored, but only the “ucb” part of the link is restored. 


FILES 
/dev/rmt/xtOh The default tape drive 
/tmp/rstdir* File containing directories on the tape 
/tmp/rstmode* Owner, mode, and time stamps for directories 
/restoresymtab Information passed between incremental restores 
SEE ALSO 


cpio(1), tar(1), dump (1M), newfs(1M), mkfs(1M), mount(1M), voleopy(1M) 


DIAGNOSTICS 
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Complains about bad key characters. 


Complains if it gets a read error. If y has been specified or the user responds 
“y”, restore will attempt to continue the restore. 


If the dump extends over more than one tape, restore will ask the user to 
change tapes. If the x or i key has been specified, restore will also ask which 
volume the user wishes to mount. The fastest way to extract a few files is to 
start with the last volume and work towards the first volume. 


There are numerous consistency checks that can be listed by restore. Most 


checks are self-explanatory or can “never happen.” Common errors are given 
below. 


Converting to new file system format 
A dump tape created from the old filesystem has been loaded. It is 
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BUGS 


automatically converted to the new filesystem format. 


<filename>: not found on tape 
The specified filename was listed in the tape directory, but was not found 
on the tape. This is caused by tape read errors while looking for the file, 
and from using a dump tape created on an active filesystem. 


expected next file <inumber>, got <inumber> 
A file that was not listed in the directory showed up. This can occur 
when using a dump tape created on an active filesystem. 


Incremental tape too low 
When doing incremental restore, a tape that was written before the pre- 
vious incremental tape or that has too low an incremental level has been 
loaded. 


Incremental tape too high 
When doing incremental restore, a tape that does not begin its coverage 
where the previous incremental tape left off or that has too high an 
incremental level has been loaded. 


Tape read error while restoring <filename> 

Tape read error while skipping over inode <inumber> 

Tape read error while trying to resynchronize 
A tape read error has occurred. Ifa filename is specified, then its con- 
tents are probably partially wrong. If an inode is being skipped or the 
tape is trying to resynchronize, then no extracted files have been cor- 
rupted, though files may not be found on the tape. 


resync restore, skipped <num> blocks 
After a tape read error, restore may have to resynchronize itself. This 
message lists the number of blocks that were skipped over. 


This error can also occur if the blocksize used to read the tape does not 
agree with the blocksize used to write it. This commonly occurs when 
tape is actually a file in the filesystem or a streamer tape where the 
write blocksize is not preserved. File damage has occured if you see this 
message. Try using the b key with the correct blocksize to overcome this 
error. 


restore can get confused when doing incremental restores from dump tapes 
that were made on active filesystems. 


When reading from tape, restore reads until it needs no more data, not until 
tape EOF. For multiple dumps saved on the same tape, you will need to 
advance the tape manually past the EOF marker after each restore is com- 
plete to get to the next dump (with “mt fsf 1”). 


A level zero dump must be done after a full restore. Because restore runs in 
user code, it has no control over inode allocation; thus a full dump must be 
done to get a new set of directories reflecting the new inode numbering, even 
though the contents of the files is unchanged. 


12/89 


DYNIX/ptx RLOG(1) 


NAME 


rlog — print log messages and other information about RCS files 


SYNOPSIS 


rlog [ options ] file ... 


DESCRIPTION 
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rlog prints information about RCS files. Files ending in ,v are RCS files, all 
others are working files. If a working file is given, rlog tries to find the corre- 
sponding RCS file first in directory ./RCS and then in the current directory, 
as explained in co(1). 


rlog prints the following information for each RCS file: RCS filename, working 
filename, head (i.e., the number of the latest revision on the trunk), default 
branch, access list, locks, symbolic names, suffix, total number of revisions, 
number of revisions selected for printing, and descriptive text. This is fol- 
lowed by entries for the selected revisions in reverse chronological order for 
each branch. For each revision, rlog prints revision number, author, 
date/time, state, number of lines added/deleted (with respect to the previous 
revision), locker of the revision (if any), and log message. Without options, 
rlog prints complete information. The options below restrict this output. 


-L Ignores RCS files that have no locks set; convenient in combina- 
tion with -R, —h, or -l. 

-R Prints only the name of the RCS file; convenient for translating a 
working filename into an RCS filename. 

-h Prints only the RCS filename, working filename, head, default 
branch, access list, locks, symbolic names, and suffix. 

-t Prints the same as -h, plus the descriptive text. 

-b Prints information about the revisions on the default branch 
(normally the highest branch on the trunk). 

—ddates Prints information about revisions with a check-in date/time in 


the ranges given by the semicolon-separated list of dates. A 
range of the form d1<d2 or d2>d1 selects the revisions that were 
deposited between d1 and d2, (inclusive). A range of the form <d 
or d> selects all revisions dated d or earlier. A range of the form 
d< or >d selects all revisions dated d or later. A range of the 
form d selects the single, latest revision dated d or earlier. The 
date/time strings d, d1, and d2 are in the free format explained 
in co(1). Quoting is normally necessary, especially for < and >. 
Note that the separator is a semicolon. 


-lflockers] Prints information about locked revisions. If the comma- 
separated list lockers of login names is given, only the revisions 
locked by the given login names are printed. If the list is omit- 
ted, all locked revisions are printed. 


-rrevisions Prints information about revisions given in the comma-separated 
list revisions of revisions and ranges. A range rev]-rev2 means 
revisions rev] to rev2 on the same branch, -rev means revisions 
from the beginning of the branch up to and including rev, and 
rev— means revisions starting with rev to the end of the branch 
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containing rev. An argument that is a branch means all revisions 
on that branch. A range of branches means all revisions on the 
branches in that range. 


-sstates Prints information about revisions whose state attributes match 
one of the states given in the comma-separated list states. 


-wilogins] Prints information about revisions checked in by users with login 
names appearing in the comma-separated list logins. If logins is 
omitted, the user’s login is assumed. 


rlog prints the intersection of the revisions selected with the options —d, 1, 
-8, -w, intersected with the union of the revisions selected by -b and -r. 


EXAMPLES 

rlog -—L -R RCS/*,v 

rlog -L -—h RCS/*,v 

rlog —L -] RCS/*,v 

rlog RCS/*,v 
The first command prints the names of all RCS files in the subdirectory RCS 
that have locks. The second command prints the headers of those files, and 
the third prints the headers plus the log messages of the locked revisions. The 
last command prints complete information. 


SEE ALSO 
ci(1), co(1), ident(1), res(1), resdiff(1), resintro(1), resmerge(1), resfile(4) 


NOTES 
Copyright 1982 by Walter F. Tichy. 


DIAGNOSTICS 
The exit status always refers to the last RCS file operated on and is 0 if the 
operation was successful, 1 otherwise. 
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NAME 


rm, rmdir — remove files or directories 


SYNOPSIS 


rm [-f] [-i] file ... 
rm -r [-f] [-i] dirname ... [file ...] 
rmdir [-p] [-s] dirname ... 


DESCRIPTION 
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ym removes the entries for one or more files from a directory. If an entry was 
the last link to the file, the file is destroyed. If the tacky bit is not set on a 
directory, removal of a file in that directory requires write permission on the 
directory, but neither read nor write permission on the file itself. If the tacky 
bit is set, you must have write permission for both the directory and the file 
you want to remove. 


Ifa file has no write permission and the standard input is a terminal, the full 
set of permissions (in octal) for the file are printed followed by a question 
mark. This is a prompt for confirmation. If the answer begins with y (for yes), 
the file is deleted, otherwise the file remains. 


Note that if the standard input is not a terminal, the command will operate as 
if the -f option is in effect. 


rmdir removes the named directories, which must be empty. 
Three options apply to rm: 


-f This option causes the removal of all files (whether write-protected or 
not) in a directory without prompting the user. Ina write-protected 
directory, however, files are never removed (whatever their permissions 
are), but no messages are displayed. If the removal of a write-protected 
directory was attempted, this option cannot suppress an error message. 


-r This option causes the recursive removal of any directories and subdirec- 
tories in the argument list. The directory will be emptied of files and 
removed. Note that the user is normally prompted for removal of any 
write-protected files which the directory contains. The write-protected 
files are removed without prompting, however, if the -f option is used, or 
if the standard input is not a terminal and the -i option is not used. 


If the removal of a non-empty, write-protected directory was attempted, 
the command will always fail (even if the -f option is used), resulting in 
an error message. 


-i With this option, confirmation of removal of any write-protected file 
occurs interactively. It overrides the -f option and remains in effect 
even if the standard input is not a terminal. 


Two options apply to rmdir: 
-p This option allows users to remove the directory dirname and its parent 
directories which become empty. A message is printed on standard out- 


put as to whether the whole path is removed or part of the path remains 
for some reason. 


-s This option is used to suppress the message printed on standard error 
when -p is in effect. 


RM(1) DYNIX/ptx 


SEE ALSO 
unlink(2), rmdir(2) 


DIAGNOSTICS 
All messages are generally self-explanatory. 


It is forbidden to remove the files "." and”.." in order to avoid the conse- 
quences of inadvertently doing something like the following: 


rm -r .* 


Both rm and rmdir return exit codes of 0 if all the specified directories are 
removed successfully. Otherwise, they return a non-zero exit code. 
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NAME 


rmdel — remove a delta from an SCCS file 


SYNOPSIS . 


rmdel -rSID files 


DESCRIPTION 


FILES 


rmdel removes the delta specified by the SID from each named SCCS file. The 
delta to be removed must be the newest (most recent) delta in its branch in 
the delta chain of each named SCCS file. In addition, the release specified 
must not be that of a version being edited for the purpose of making a delta 
(that is, if a p-file [see get(1)] exists for the named SCCS file, the release speci- 
fied must not appear in any entry of the p-file). 


The -r option is used for specifying the SID (SCCS Identification) level of the 
delta to be removed. 


If a directory is named, rmdel behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files (last component of 
the pathname does not begin with s.) and unreadable files are silently 
ignored. If a name of -is given, the standard input is read. Each line of the 
standard input is taken to be the name of an SCCS file to be processed; non- 
SCCS files and unreadable files are silently ignored. 


Simply stated, (1) if you make a delta you can remove it; or (2) if you own the 
file and directory you can remove a delta. 


x.file [See delta(1)] 
z.file [See delta(1)] 


SEE ALSO 


delta(1), get(1), help(1), prs(1), scesfile(4) 


DIAGNOSTICS 
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Use help(1) for explanations. 
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NAME 

rmvopt — remove a menu option 
SYNOPSIS 

rmvopt -M menu-name -t task-name [-F] 
DESCRIPTION 

This command removes an option from a menu on the ptx/ADMIN menu sys- 

tem. 

Mparentmenu The name of the menu that displays the option. For example, 
clprint. 

d taskname The name of task that the option calls. For example, the 
name of the task for the Display Outstanding Calls task is 
dspcalls. 

-F Use the -F option to delete all of the files that support the 
task. If you do not select this option, the system removes the 
option from its parentmenu, but related files will remain on 
the system. 

Environment Variables 


TFADMFILE Identifies the directory where the ptx/ADMIN administrative 
data files are located. 


FILES 
${TFADMFILE}/etc/task 
Task table 
${TFADMFILE})/menus/chap1parentmenu 
Menu displaying the option 
SEE ALSO 
addcmdopt(1M), addformopt(1M), addmenuopt(1M) 
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NAME 


run —run an executable 


SYNOPSIS 


run [-s] [-e] [-n] [-t title] program 


DESCRIPTION 


The run command runs a program, using the$PATH environment variable to 
find it. The -s option means silent, meaning that the screen is not redrawn 
when this is done. The -e option prompts the user before returning to the 
Interpreter only if there is an error condition (by default the user is always 
prompted). The -n option never prompts the user (useful for programs like vi 
which the user must do some specific action to exit anyway). The —-t option 
gives the name this process will have in the pop-up menu generated by the 
frm-list command. This option implies the ability to suspend the operating 
system process and return to the FMLI application. 


EXAMPLES 
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Here is a menu that uses run: 


menu="Edit special System files" 


* name="Password file" 


action=‘run -e vi /etc/passwd* 


name="Group file" 
action=‘run -e vi /etc/group* 


name="My .profile" 
action=‘run -n vi SHOME/.profile* 
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NAME 


RUNACCT(1M) 


runacct — run daily accounting 


SYNOPSIS 


/usr/lib/acct/runacct [mmdd [state]] 


DESCRIPTION 
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runacct is the main daily accounting shell procedure. It is normally initiated 
via cron(1M). runacct processes connect, fee, disk, and process accounting 
files. It also prepares summary files for prdaily or billing purposes. 


runacct takes care not to damage active accounting files or summary files in 
the event of errors. It records its progress by writing descriptive diagnostic 
messages into active. When an error is detected, a message is written to 
/dev/console, mail (see mail(1)) is sent to root and adm, and runacct termi- 
nates. runacct uses a series of lock files to protect against re-invocation. The 
files lock and lock1 are used to prevent simultaneous invocation, and lastdate 
is used to prevent more than one invocation per day. 


runacct breaks its processing into separate, restartable states using statefile 
to remember the last state completed. It accomplishes this by writing the 
state name into statefile. runacct then looks in statefile to see what it has 
done and to determine what to process next. states are executed in the follow- 
ing order: 


SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date changes if nec- 
essary. 

CONNECT1 Produce connect session records in ctmp.h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct.h format. 

MERGE Merge the connect and process accounting records. 

FEES Convert output of chargefee into tacct.h format and merge 
with connect and process accounting records. 

DISK Merge disk accounting records with connect, process, and fee 
accounting records. 


MERGETACCT Merge the daily total accounting records in daytacct with the 
summary total accounting records in 
/usr/adm/acct/sum/tacct. 


CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs can be 
included here. 

CLEANUP Cleanup temporary files and exit. 


To restart runacct after a failure, first check the active file for diagnostics, 
then fix up any corrupted data files such as pacct or wtmp. The lock files and 
lastdate file must be removed before runacct can be restarted. The argument 
mmdd is necessary if runacct is being restarted. It specifies the month and 
day for which runacct will rerun the accounting. Entry point for processing 
is based on the contents of statefile. To override this, include the desired state 
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on the command line to designate where processing should begin. 


EXAMPLES 
To start runacct: 
nohup runacct 2> /usr/adm/acct/nite/fd2log & 


To restart runacct: 
nohup runacct 0601 2>> /usr/adm/acct/nite/fd2log & 


To restart runacct at a specific state: 
nohup runacct 0601 MERGE 2>> /usr/adm/acct/nite/fd2log & 


FILES 
/etc/wtmp 
/usr/adm/pacct* 
/usr/src/cmd/acct/tacct.h 
/usr/src/cmd/acct/ctmp.h 
/usr/adm/acct/nite/active 
/usr/adm/acct/nite/daytacct 
Ausr/adm/acct/nite/lock 
/usr/adm/acct/nite/lock1 
/usr/adm/acct/nite/lastdate 
/usr/adm/acct/nite/statefile 
/usr/adm/acct/nite/ptacct*.mmdd 


SEE ALSO 
acctcom(1), mail(1), acct(1M), acctems(1M), acctcon(1M), acctmerg(1M), 
acctpre(1M), acctsh(1M), cron(1M), fwtmp(1M), acct(2), acct(4), utmp(4) 


BUGS 
Normally it is not a good idea to restart runacct in the SETUP state. Run 
SETUP manually and restart via: 


runacct mmdd WIMPFIX 
If runacct failed in the PROCESS state, remove the last ptacct file. 
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& NAME 
SYNOPSIS 
sact files 


DESCRIPTION 


SACT(1) 


sact — print current SCCS file editing activity 


sact informs the user of any impending deltas to a named SCCS file. This situ- 
ation occurs when get(1) with the -e option has been previously executed 
without a subsequent execution of delta(1). If a directory is named on the 
command line, sact behaves as though each file in the directory were specified 
as a named file, except that non-SCCS files and unreadable files are silently 
ignored. If a name of —is given, the standard input is read with each line 
being taken as the name of an SCCS file to be processed. 


The output for each named file consists of five fields separated by spaces. 


Field 1 


Field 2 
Field 3 


Field 4 
Field 5 


Specifies the SID of a delta that currently exists in the SCCS 
file to which changes will be made to make the new delta. 


Specifies the SID for the new delta to be created. 


Contains the logname of the user who will make the delta 
(that is, who executed a get for editing). 


Contains the date that get -e was executed. 
Contains the time that get -e was executed. 


SEE ALSO 
) delta(1), get(1), unget(1) 


DIAGNOSTICS 


Use help(1) for explanations. 
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NAME 


sag — system activity graph 


SYNOPSIS . 


sag [ options ] 


DESCRIPTION 


sag graphically displays the system activity data stored in a binary data file 
by a previous sar(1) run. Any of the sar data items can be plotted singly or in 
combination; as cross plots, or versus time. Simple arithmetic combinations of 
data may be specified. sag invokes sar and finds the desired data by string- 
matching the data column header (run sar to see what is available). These 
options are passed through to sar: 


-stime Select data later than time in the form hh[:mm]. Default is 08:00. 

-etime Select data up to time. Default is 18:00. 

-i sec Select data at intervals as close as possible to sec seconds. 

-f file Use file as the data source for sar. Default is the current daily data 
file /usr/adm/sa/sadd. 

Other options: 


-T term Produce output suitable for terminal term. See tplot(1G) for known 
terminals. Default for term is $TERM. 


-x spec x axis specification with spec in the following form: 
namefop name]...[lo hi]" 
-y spec y axis specification with spec in the same form as above. 


name is either a string that will match a column header in the sar report with 
an optional device name in square brackets (such as r+w/s[dsk-1)) or an inte- 
ger value. Op is +-—* or /surrounded by blanks. Up to five names may be 
specified. Parentheses are not recognized. Contrary tocustom, + and - 
have precedence over * and /. Evaluation is left to right. Thus 

A/A+B * 100is evaluated (A(A+B)}100, andA + B/C + Dis 
(A+B)(C+D). lo and hi are optional numeric scale limits. If unspecified, they 
are deduced from the data. 


A single spec is permitted for the x axis. If unspecified, time is used. Up to 5 
spec’s separated by semicolons (;) may be given for -y. Enclose the -x and -y 
arguments in quotes ("") if they include whitespace. The —-y default is: 


-y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + ZHwio 0 100" 


EXAMPLES 
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To see today’s CPU utilization, type this command: 
sag 
To see activity over 15 minutes of all disk drives: 


TS=date +%H:%M 

sar ~—o tempfile 60 15 

TE="date +%H:%M 

sag -f tempfile -s $TS -e $TE -y "r+w/s[dsk]" 
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FILES 
fusr/adm/sa/sadd Daily daiaGilefiacdayd © 


SEE ALSO 
sar(1), tplot(1G) 
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NAME 
@ 2 sar — system activity reporter 


SYNOPSIS 
sar [-ubdycwaqvmprA] [-o file] t [n J] 
sar [-ubdycwaqvmprA] [-s time] [-e time] [-i sec] [-f file] 
DESCRIPTION 
sar, in the first instance, samples cumulative activity counters in the operat- 
ing system at n intervals of t seconds, where ¢ should be 5 or greater. If the -o 
option is specified, it saves the samples in file in binary format. The default 
value of n is 1. In the second instance, with no sampling interval specified, 
sar extracts data from a previously recorded file, either the one specified by 
the -f option or, by default, the standard system activity daily data file 
/usr/adm/sa/sa dd for the current day dd. The starting and ending times of 
the report can be bounded via the -s and -e time arguments of the form 
hh[:mm[:ss]]. The -i option selects records at sec second intervals. Otherwise, 
all intervals found in the data file are reported. 


In either case, subsets of data to be printed are specified by option: 
-u_ Report CPU utilization (the default): 
Yousr, Ysys, Yowio, idle ~ portion of time running in user mode, running 
in system mode, idle with some process waiting for block I/O, and other- 
wise idle. 
& ~-b_ = Report buffer activity: 


bread/s, bwrit/s — transfers per second of data between system buffers 
and disk or other block devices; 


lread/s, lwrit/s — accesses of system buffers; 


Yorcache, Yowcache ~ cache hit ratios, i. e., (1-bread/Iread) as a percent- 
age; 
pread/s, pwrit/s — transfers via raw (physical) device mechanism. 


-d Report activity for each block device such as a disk or tape drive. When 
data is displayed, the device specification dsk- is generally used to repre- 
sent a disk drive. The device specification used to represent a tape drive 
is machine dependent. The following activity data is reported: 


%busy, avque — portion of time device was busy servicing a transfer 
Tequest, average number of requests outstanding during that time; 


r+w/s, blks/s — number of data transfers from or to device, number of 
bytes transferred in 512-byte units; 


avwait, avserv — average time in ms. that transfer requests wait idly on 
queue, and average time to be serviced (which for disks includes seek, 
- rotational latency and data transfer times). 


~y Report TTY device activity: 


rawch/s, canch/s, outch/s — input character rate, input character rate 
processed by canon, output character rate; 


revin/s, xmtin/s, mdmin/s — receive, transmit and modem interrupt rates. 
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-c Report system calls: 
scall/s — system calls of all types; 
sread/s, swrit/s, fork/s, exec/s — specific system calls; 
rchar/s, wchar/s — characters transferred by read and write system calls. 


-w Report system swapping and switching activity: 


swpin/s, swpot/s, bswin/s, bswot/s — number of transfers and number of 
512-byte units transferred for swapins and swapouts (including initial 
loading of some programs); 


pswch/s — process switches. 

-a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

-q Report average queue length while occupied, and % of time occupied: 
rungq-sz, %runocc — run queue of processes in memory and runnable; 


Swpq-sz, Yswpocc — swap queue of processes swapped out but ready to 
run. 


-v__ Report status of process, inode, file tables: 


text-sz, proc-sz, inod-sz, file-sz, lock-sz — entries/size for each table, 
evaluated once at sampling point; 


ov — overflows that occur between sampling points for each table. 


-m_ Report message and semaphore activities: 
msg/s, sema/s — primitives per second. 
-p Report paging activities: 
vfit/s — address translation page faults (valid page not in memory); 


pfit/s — page faults from protection errors (illegal access to page) or 
“copy-on-writes” (always 0 under DYNIX); 


pefil/s — vfit/s satisfied by page-in from filesystem; 

relm/s — valid pages reclaimed for free list (always 0 under DYNIX). 
-r Report unused memory pages and disk blocks: 

freemem — average pages available to user processes; 

freeswap — disk blocks available for process swapping. 
-A_ Report all data. Equivalent to -udqbwcayvmpr. 


EXAMPLES 
To see today’s CPU activity so far: 


sar 

To watch CPU activity evolve for 10 minutes and save data: 
sar -o temp 6010 

To later review disk and tape activity from that period: 


2 12/89 


DYNIX/ptx SAR(1) 


sar -d -f temp 
@ FILES 


/usr/adm/sa/sadd Daily data file, where dd are digits representing the day 
of the month. 


SEE ALSO 
sag(1G), sar(1M) 
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NAME 


sar: sal, sa2, sadc — system activity report package 


SYNOPSIS 


/usr/lib/sa/sadc [t n] [ofile] 


/usr/lib/sa/sal1 [t n] 
/usr/lib/sa/sa2 [-ubdycwaqvmprA] [-s time] [-e time] [-i sec] 


DESCRIPTION 
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System activity data can be accessed at the special request of a user (see 
sar(1)) and automatically on a routine basis as described here. The operating 
system contains a number of counters that are incremented as various system 
actions occur. These include counters for CPU utilization, buffer usage, disk 
and tape I/O activity, TTY device activity, switching and system-call activity, 
file-access, queue activity, inter-process communications, and paging. 


sade and shell procedures, sal and sa2, are used to sample, save, and process 
this data. 


sadc, the data collector, samples system data n times every t seconds and 
writes in binary format to ofile or to standard output. The sampling interval ¢ 
should be greater than 5 seconds; otherwise, the activity of sadc itself may 
affect the sample. Ift and n are omitted, a special record is written. This 
facility is used at system boot time, when booting to a multiuser state, to mark 
the time at which the counters restart from zero. For example, the 
/etc/init.d/perf file writes the restart mark to the daily data by the command 
entry: 


su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sa* date +$d°" 


The shell script sal, a variant of sade, is used to collect and store data in 
binary file /usr/adm/sa/sadd where dd is the current day. The arguments t 
and n cause records to be written n times at an interval of t seconds, or once if 
omitted. The following entries in /usr/spool/cron/crontabs/sys (see 
cron(1M)) will produce records every 20 minutes during working hours and 
hourly otherwise. 


0 * * * 0-6 /usr/lib/sa/sal 

20,40 8-17 * * 1-5 /usr/lib/sa/sal 
The shell script sa2, a variant of sar(1), writes a daily report in file 
/usr/adm/sa/sardd. The options are explained in sar(1). The following 
/usr/spool /cron/crontabs/sys entry will report important activities hourly 
during the working day. 


5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -a 
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The structure of the binary daily data file consists of one word (int) which 
denotes the number of elements in the devio array actually written followed 
by zero or more copies of the sa structure defined as follows: 


struct sa { 
struct sysinfo si; 
struct minfo mi; 


int szinode; /* current size of inode table ¢/ 

int szfile; /* current size of file table */ 

int szproc; /* current size of proc table *%/ 

int szlckf; /* current size of file record header table */ 
int szlckr; /* current size of file record lock table */ 
int mszinode;/* size of inode table *%/ 

int mszfile; /* size of file table */ 

int mszproc; /* size of proc table *¢/ 

int mszlckf;/* maximum size of file record header table */ 
int mszlckr;/* maximum size of file record lock table */ 
long inodeovf; /* cumulative overflows of inode table */ 
long fileovf;/* cumulative overflows of file table ¢/ 

long procovf;/* cumulative overflows of proc table */ 


time_t ts; fe 
struct dev_stats 


time stamp, seconds */ 

devio(Npevs];/* device unit information *%/ 
ie 

where: 


struct sysinfo { 
time_t cpu[5S]; 


fdefine cPU_IDLE 0 
#define CPU_USER 1 
fdefine CPU_LKERNEL 2 
fdefine cPuU_WAIT 3 
fdefine cpu_sxBRK 4 
time_t wait(3]; 
fdefine w_1o 0 
S§define w_swaP 1 
fdefine w_P1o 2 
long bread; 
long bwrite; 
long lread; 
long lwrite; 
long phread; 
long phwrite; 
long swapin; 
long swapout; 
long bswapin; 
long  bswapout; 
long  pswitch; 
long syscall; 
long remcall; 
long fileop; 
long serve; 
long sysread; 
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long syswrite; 
© long sysfork; 
long sysexec; 


long runque; 
long runocc; 
long  swpque; 
long swpocc; 
long iget; 
long namei; 
long dirblk; 
long readch; 
long = writech; 
long revint; 
long = xmtint; 
long = mdmint; 
long rawch; 
long canch; 
long  outch; 
long msg; 

long sema; 
long pnpfault; 
long wrtfault; 


struct minfo { 
unsigned long freemem[2); /* freemem in pages */ 


/* "double" long format*/ 
/* freemem(0] least significant */ 


long freeswap; /* free swap space */ 

long vfault; /* translation fault ¢/ 

long demand; /* demand zero and demand fill pages */ 
long swap; /* pages on swap */ 

long cache; /* pages in cache ¢/ 

long file; /* pages on file */ 

long pfault; 

long cw; 


long steal; mi 
long freedpgs; 
long unmodsw; 
long  unmodfl; 


struct dev_stats { 
char d_name[12]); /* device name */ 


ulong d_ops; /* number of 1/o requests since boot */ 
ulong d_blks; /* number of DEv_BsiIzz blocks xferred */ 
ulong d_active; /* cumulative time device was active */ 
/* in milliseconds */ 
@ ulong d_resp; /* cumulative response time in milliseconds ¢/ 
ie 
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The following fields in struct sysinfo will always be 0: remcall, fileop, 
serve, pnpfault, and wrtfault. The following fields in struct minfo struc- 
ture will always be 0: pfault, cw, steal, freedpgs, unmodsw, and unmodfl. 


FILES 
/usr/adm/sa/sadd_ Daily data file 
/usr/adm/sa/sardd Daily report file 
/tmp/sa.adrfl Address file 


SEE ALSO 
cron(1M), sag(1G), sar(1), timex(1) 
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NAME 


savecore — save a core dump of the operating system 


SYNOPSIS 


/etc/savecore dirname [ system ] 
/etc/savecore —c 


/etc/savecore -q 


DESCRIPTION 


FILES 


savecore is meant to be called in /etc/init.d/savecore. This file is hard- 
linked to /etc/rc2.d/<sequence_number>savecore . Its function is to save the 
core dump of the system (assuming one was made). 


savecore saves the core image in the file dirname/umcore.n. (The default file 
is /usr/crash.) If the core dump corresponds with the current running /unix 
or the kernel specified in system, it is saved in dirname/unix.n. The trailing 
-n in the pathnames is replaced by a number that grows every time savecore 
is run in that directory. savecore also saves the output from /etc/dmesg(1M) 
into dirname/dmesg.n. 


Before savecore writes out a core image, it reads a number from the file dir- 
name/minfree. If there are fewer free blocks on the filesystem which contains 
dirname than the number obtained from the minfree file, the core dump is not 
done. If the minfree file does not exist, savecore always writes out the core 
file (assuming that a core dump was taken). 


If the core dump was from a system other than /unix, the name of that system 
must be supplied as sysname. 


If savecore is invoked with -c, the dump, if one exists, is cleared (that is, dis- 
carded). 


If savecore is invoked with -q, savecore checks to see if a dump exists. Ifa 
dump exists, Dump existsis printed. Otherwise, No dumpis printed. 


Warning: Savecore uses information in the disk’s VTOC to determine how big 
the dump partition is. This implies that disks which are used for dump areas 
must have a VTOC present on them. See mkvtoc(1M) for information on 
adding a VTOC to the disk. 


/unix Current operating system 


SEE ALSO 


mkvtoc(1M), prtvtoc(1M), showcfg(1M), dump(8) 


DYNIX/ptx SCCSDIFF(1) 


NAME 

sccsdiff — compare two versions of an SCCS file 
SYNOPSIS 

seesdiff -rSID1 -rSID2 [-p] [-sn] files 
DESCRIPTION 


secsdiff compares two versions of an SCCS file and generates the differences 

between the two versions. Any number of SCCS files may be specified, but 

arguments apply to all files. 

-rSID? ‘SIDI and SID2 specify the deltas of an SCCS file that are to be com- 
pared. Versions are passed to bdiff(1) in the order given. 


-p Pipe output for each file through pr(1). 
-sn nis the file segment size that bdiff will pass to diff(1). This is use- 
ful when diff fails due to a high system load. 
FILES 
/tmp/get????7? Temporary files 
SEE ALSO 
bdiff{1), get(1), help(1), pr(1) 
DIAGNOSTICS 


“ file : No differences” The two versions are the same. 


Use help(1) for explanations. 
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NAME 
sccstorcs — build RCS file from SCCS file 

SYNOPSIS 
sccstores [-t] [-v] s.file ... 

DESCRIPTION 
scestorcs builds an RCS file from each SCCS file argument. The deltas and 
comments for each delta are preserved and installed into the new RCS file in 
order. Also preserved are the user access list and descriptive text, if any, from 
the SCCS file. 
The following flags are meaningful: 


+t Trace only. Prints detailed information about the SCCS file and lists 
the commands that would be executed to produce the RCS file. No 
commands are actually executed and no RCS file is made. 


-v Verbose. Prints each command that is run while it is building the 
RCS file. 
FILES 
For each s.somefile, secstorcs writes the files somefile and somefile,v which 
should not already exist. sccstorcs will abort, rather than overwrite those 
files if they do exist. 
SEE ALSO 
ci(1), co(1), res(1) 
NOTES 
Copyright 1983 by Kenneth L. Greer 
DIAGNOSTICS 
All diagnostics are written to stderr. 


Non-zero exit status on error. 


BUGS 
scestores does not preserve all SCCS options specified in the SCCS file. Most 
notably, it does not preserve removed deltas, MR numbers, and cutoff points. 
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NAME 
& sdiff — side-by-side difference program 


SYNOPSIS 
sdiff [ options ... ] filel file2 


DESCRIPTION 
sdiff uses the output of diff(1) to produce a side-by-side listing of two files 
indicating those lines that are different. Each line of the two files is printed 
with a blank gutter between them if the lines are identical, a < in the gutter if 
the line only exists in file], a > in the gutter if the line only exists in file2, and 
a | for lines that are different. 


Following is a sample of the output sdiff produces: 


x | y 

a a 

b < 

c < 

d d 
> (el 


The following options exist: 


-wn Use the next argument, n, as the width of the output line. The 
default line length is 130 characters. 
-l Print only the left side of any lines that are identical. 
@ -8 Do not print identical lines. 
-o output Use the next argument, output, as the name of a third file that is 


created as a user-controlled merging of file1 and file2. Identical 
lines of filel and file2 are copied to output. Sets of differences, as 
produced by diff(1), are printed; where a set of differences share a 
common gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for the user to type one 
of the following commands: 


1 Append the left column to the output file 

r Append the right column to the output file 

8 Turn on silent mode; do not print identical lines 
v Turn off silent mode 


el Call the editor with the left column 
er _ Call the editor with the right column 


eb Call the editor with the concatenation of left and 
right 

e Call the editor with a zero-length file 

q Exit from the program 


On exit from the editor, the resulting file is concatenated on the 
@ end of the output file. 
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SEE ALSO 
diff{1), ed(1) 
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NAME 


sed — stream editor 


SYNOPSIS 


sed [-n] [-e script] [-f sfile] [files] 


DESCRIPTION 
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sed copies the named files (standard input default) to the standard output, 
edited according to a script of commands. The -f option causes the script to be 
taken from file sfile; these options accumulate. If there is just one -e option 
and no -f options, the flag -e can be omitted. The —n option suppresses the 
default output. A script consists of editing commands, one per line, of the fol- 
lowing form: 


[ address [ , address ] ] function [ arguments ] 


In normal operation, sed cyclically copies a line of input into a pattern space 
(unless there is something left after a D command), applies in sequence all 
commands whose addresses select that pattern space, and at the end of the 
script copies the pattern space to the standard output (except under -n) and 
deletes the pattern space. 


Some of the commands use a hold space to save all or part of the pattern space 
for subsequent retrieval. 


An address is either a decimal number that counts input lines cumulatively 
across files, a $ that addresses the last line of input, or a context address, i.e., 
a /regular expression/ in the style of ed(1), modified as follows: 


-—  Inacontext address, the construction \?regular expression? (where ? is 
any character) is identical to /regular expression/. Note that in the con- 
text address \xabc\xdefx, the second x stands for itself, so that the reg- 
ular expression is abexdef. 


- The escape sequence \n matches a newline embedded in the pattern 
space. 


-  Aperiod(.) matches any character except the terminal newline of the 
pattern space. 


-— Acommand line with no addresses selects every pattern space. 


- Acommand line with one address selects each pattern space that matches 
the address. 


- Acommand line with two addresses selects the inclusive range from the 
first pattern space that matches the first address through the next pat- 
tern space that matches the second. (If the second address is a number 
less than or equal to the line number first selected, only one line is 
selected.) Thereafter the process is repeated, looking again for the first 
address. 


Editing commands can be applied only to non-selected pattern spaces by use of 
the negation function ! (below). 

In the following list of functions, the maximum number of permissible 
addresses for each function is indicated in parentheses. 


The text argument consists of one or more lines, all but the last of which end 
with \ to hide the newline. Backslashes in text are treated like backslashes in 
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the replacement string of an s command, and may be used to protect initial 
blanks and tabs against the stripping that is done on every script line. The 
rfile or wfile argument must terminate the command line and must be pre- 
ceded by exactly one blank. Each wfile is created before processing begins. 
There can be at most 10 distinct wfile arguments. 


(1)a\ 

text Append. Place text on the output before reading the next input 
line. 

(2)blabel Branch to the : command bearing the label. If label is empty, 
branch to the end of the script. 


(2)c\ 

text Change. Delete the pattern space. With 0 or 1 address or at the 
end of a 2-address range, place text on the output. Start the next 
cycle. 

(2)d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through the first 
newline. Start the next cycle. 

(2)g Replace the contents of the pattern space by the contents of the 
hold space. 

(2)G Append the contents of the hold space to the pattern space. 

(2)h Replace the contents of the hold space by the contents of the pat- 
tern space. 

(2)H Append the contents of the pattern space to the hold space. 

(1)iN 

text Insert. Place text on the standard output. 

(2)1 List the pattern space on the standard output in an unambigu- 


ous form. Non-printable characters are displayed in octal nota- 
tion and long lines are folded. 


(2)n Copy the pattern space to the standard output. Replace the pat- 
tern space with the next line of input. 


(2)N . Append the next line of input to the pattern space with an 
embedded newline. (The current line number changes.) 

(2)p Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first 
newline to the standard output. 

(lq Quit. Branch to the end of the script. Do not start a new cycle. 


(2)r rfile Read the contents of rfile. Place them on the output before read- 
ing the next input line. 


(2) s/regular expression/replacement/flags 
Substitute the replacement string for instances of the regular 
expression in the pattern space. Any character may be used 
instead of /. For a fuller description, see ed(1). flags can be zero 
or more of the following: 
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n n= 1-512. Substitute for just the n-th occurrence of the 
regular expression. 
zg Global. Substitute for all nonoverlapping instances of 


the regular expression rather than just the first one. 
+) Print the pattern space if a replacement was made. 


wufile Write. Append the pattern space to wfile if a replace- 
ment was made. 


(2)tlabel Test. Branch to the : command bearing the label if any substitu- 
tions have been made since the most recent reading of an input 
line or execution of at. If label is empty, branch to the end of the 
script. 

(2)wwfile Write. Append the pattern space to wfile. 

(2)x Exchange the contents of the pattern and hold spaces. 

(2) y/string1/string2/ 

Transform. Replace all occurrences of characters in string] with 
the corresponding character in string2. The lengths of string1 
and string2 must be equal. 

(2)! function Don’t. Apply the function (or group, if function is {) only to lines 
not selected by the address(es). 

(0): label This command does nothing; it bears a label for b and t com- 
mands to branch to. 

(1)= Place the current line number on the standard output as a line. 

(2){ Execute the following commands through a matching } only 
when the pattern space is selected. 

(0) An empty command is ignored. 

(0) # Ifa # appears as the first character on the first line of a script 
file, then that entire line is treated as a comment, with one 
exception. If the character after the # is an’n’, then the default 
output will be suppressed. The rest of the line after #n is also 
ignored. A script file must contain at least one non-comment 
line. 

SEE ALSO 


awk(1), ed(1), grep(1) 
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NAME 
@ set, unset — set.and unset environment variables in core or in files 
SYNOPSIS 
set —<] | filename | e variable=value> ... | set —<1 | f filename | e> 
variable 


unset —<] | ffilename variable> .. . 


DESCRIPTION 


The set built-in can be used to set variables in the environment or to add vari- 
ables to environment-like files. The unset built-in removes these variables. 
There are two built-in environments; a local one and the operating system 
environment which passes variables between processes. These are accessed 
by the -l and -e options, respectively. When expanding variables, the Inter- 
preter checks the local environment first, then the operating system environ- 
ment. If you use a filename with the -f option, you must include that filename 
when you are expanding variables (e.g. ${(filename) VARIABLE). 


If a variable name is given without equating it to a value, set expects the 
value to be on stdin. 


EXAMPLES 


» Storing a selection made in a menu: 


name=Selection 2 
action=‘set -1 SELECTION=2 ‘close 


SEE ALSO 


env(1), sh(1) 


WARNINGS 
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Note that at least one of the allowed switches must be used. 
Note that a switch must be used for each variable being set or unset. 
Note that there is no space between the -f option and the filename. 


Operating system environment variables (those set using the —-e) can be set 
only for the current FMLI process and the processes it calls. 


When the -f option is specified, other users of the Interpreter on the same 
machine can expand these variables unless the filename is unique to the pro- 
cess. 
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NAME 
setcolor — redefine or create a color 


SYNOPSIS 
setcolor color red_level green_level blue_level 


DESCRIPTION 
The setcolor command takes four arguments; a string naming the color, and 
three integers defining the intensity of the red, green, and blue components of 
the color, respectively. If you are redefining an existing color, you must use its 
current name (the default colors are black, blue, green, cyan, red, magenta, 
yellow, and white). Intensities must be in the range of 0 to 1000. The function 
returns the color’s name string. 


EXAMPLES 
‘setcolor blue 100 24 300° 
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NAME 
setmnt — establish mount table 


SYNOPSIS 
/ete/setmnt 


DESCRIPTION 
setmnt creates the /etc/mnttab table, which is needed for both the 
mount(1M) and umount commands. setmnt reads standard input and cre- 
ates a mnttab entry for each line. Input lines have this format: 

filesys node 

filesys is the name of the filesystem’s special file (for example, 
/dev /dsk/zd0s0) and node is the root name of that filesystem. Thus filesys 
and node become the first two items in the mount table entry. 

FILES 
/etc/mnttab 

SEE ALSO 
mount(1M) 

BUGS 
Problems may occur if filesys or node are longer than 32 characters. 
setmnt silently enforces an upper limit on the maximum number of mnttab 
entries. 
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NAME 
setpgrp — run command in its own process group 


SYNOPSIS . 
setpgrp commands [ args ] ... 


DESCRIPTION 
Sets the process group ID of command to the process ID of command. This 
sets things so that command runs in its own process group. 

SEE ALSO 
setpgrp(2) 
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NAME 


setup — initialize system for first user 


SYNOPSIS 


setup 


DESCRIPTION 


The setup command, which is also accessible as a login by the same name, 
allows the first user to be established as the owner of the machine. 


The user is permitted to add the first logins to the system, usually starting 
with his or her own. 


The user can then protect the system from unauthorized modification of the 
machine configuration and software by giving passwords to the administrative 
and maintenance functions. Normally, the first user of the machine enters 
this command through the setup login, which initially has no password, and 
then gives passwords to the various functions in the system. If the user does 
not assign a password to a function, it can be exercised by anyone. 


The user can then give passwords to system logins such as root and bin (pro- 
vided they do not already have passwords). Once given a password, each login 
can be changed only by that login or root. 


The user can then set the date, time and time zone of the machine. 
The user can then set the node name of the machine. 


SEE ALSO 


passwd(1) 


DIAGNOSTICS 


The passwd(1) command complains if the password provided does not meet 
its standards. 


WARNINGS 


12/89 


If the setup login is not under password control, anyone can put passwords on 
the other functions. 


DYNIX/ptx SH(1) 


NAME 


sh, rsh — shell, the standard/restricted command programming language 


SYNOPSIS 


sh [ -acefhiknrstuvx ] [ args ] 
rsh [ -acefhiknrstuvx ] [ args ] 


DESCRIPTION 


sh is a command programming language that executes commands read from a 
terminal or a file. rsh is a restricted version of the standard command inter- 
preter sh; it is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. See Invoca- 
tion below for the meaning of arguments to the shell. 


Definitions 


Ablank is a tab or a space. A name is a sequence of letters, digits, or under- 
scores beginning with a letter or underscore. A parameter is a name, a digit, 
or any of the characters *, @, #, ?, -, $, and!. 


Commands 
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Asimple-command is a sequence of non-blank words separated by blanks. The 
first word specifies the name of the command to be executed. Except as speci- 


* fied below, the remaining words are passed as arguments to the invoked com- 


mand. The command name is passed as argument 0 (see exec(2)). The value 
of a simple-command is its exit status if it terminates normally, or (octal) 
200+status if it terminates abnormally (see signal(2) for a list of status val- 
ues). 


A pipeline is a sequence of one or more commands separated by |. The stan- 
dard output of each command but the last is connected by a pipe(2) to the 
standard input of the next command. Each command is run as a separate pro- 
cess; the shell waits for the last command to terminate. The exit status ofa 
pipeline is the exit status of the last command. 


A list is a sequence of one or more pipelines separated by ;, & &&, or | |, and 
optionally terminated by ; or &. Of these four symbols, ; and & have equal 
precedence, which is lower than that of && and | |. The symbols && and | | 
also have equal precedence. A semicolon (;) causes sequential execution of the 
preceding pipeline; an ampersand (&) causes asynchronous execution of the 
preceding pipeline (i.e., the shell does not wait for that pipeline to finish). The 
symbol && ( | |) causes the list following it to be executed only if the preced- 
ing pipeline returns a zero (non-zero) exit status. An arbitrary number of 
newlines (instead of semicolons) may appear in a list to delimit commands. 


Acommandis either a simple-command or one of the following. Unless other- 
wise stated, the value returned by a command is that of the last simple-com- 
mand executed in the command. 


for name [ in word ... ] do list done 
Each time a for command is executed, name is set to the next word 
taken from the in word list. Ifin word ... is omitted, then the for 
command executes the do list once for each positional parameter that 
is set (see Parameter Substitution below). Execution ends when 
there are no more words in the list. 
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case word in[ pattern [ | pattern ]...) list 33]... esac 
A case command executes the list associated with the first pattern 
that matches word. The form of the patterns is the same as that used 
for filename generation (see Filename Generation) except that a 
slash, a leading dot, or a dot immediately following a slash need not be 
matched explicitly. 

if list then Jist [ elif list then list ]...[ else list ] fi 
The list following if is executed and, ifit returns a zero exit status, the 
list following the first then is executed. Otherwise, the list following 
elif is executed and, if its value is zero, the list following the next 
then is executed. Failing that, the else list is executed. If no else list 
or then Jist is executed, then the if command returns a zero exit sta- 
tus. 


while list do list done 
A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list; 
otherwise the loop terminates. If no commands in the do list are exe- 
cuted, then the while command returns a zero exit status; until may 
be used in place of while to negate the loop termination test. 


(list) Execute list in a sub-shell. 
{list;} list is executed in the current (that is, parent) shell. 


name () {list;} 
Define a function which is referenced by name. The body of the func- 
tion is the list of commands between { and}. Execution of functions is 
described below (see Execution). 


The following words are only recognized as the first word of a command and 
when not quoted: 


if then else elif fi case esac for while until do done { } 


Comments 


A word beginning with # causes that word and all the following characters up 
to a newline to be ignored. 


Command Substitution 


The shell reads commands from the string between two grave accents (**) and 
the standard output from these commands may be used as all or part of a 
word. Trailing newlines from the standard output are removed. 


No interpretation is done on the string before the string is read, except to 
remove backslashes (\) used to escape other characters. Backslashes may be 
used to escape a grave accent (>) or another backslash (\) and are removed 
before the command string is read. Escaping grave accents allows nested com- 
mand substitution. If the command substitution lies within a pair of double 
quotes ("... ...° ..."), a backslash used to escape a double quote (\") will be 
removed; otherwise, it will be left intact. 


Ifa backslash is used to escape a newline character (\newline), both the 
backslash and the newline are removed (see the later section on Quoting). In 
addition, backslashes used to escape dollar signs (\$) are removed. Since no 
interpretation is done on the command string before it is read, inserting a 
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backslash to escape a dollar sign has no effect. Backslashes that precede char- 
acters other than backslash (\), grave accent ( ), double quotes ("), newline, 
and dollar sign ($) are left intact when the command string is read. 


Parameter Substitution 
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The character $ is used to introduce substitutable parameters. There are two 
types of parameters, positional and keyword. If parameter is a digit, itis a 
positional parameter. Positional parameters may be assigned values by set. 
Keyword parameters (also known as variables) may be assigned values by 
writing: 

name=value [ name=value }... 


Pattern-matching is not performed on value. There cannot be a function anda 
variable with the same name. 


${parameter} 
The value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or under- 
score that is not to be interpreted as part of its name. If parameter is 
* or @, all positional parameters, starting with $1, are substituted 
(separated by spaces). Parameter $0 is set from argument zero when 
the shell is invoked. 


${parameter:-word} 
If parameter is set and is non-null, substitute its value; otherwise sub- 
stitute word. 

${parameter:=word} 
If parameter is not set or is null set it to word; the value of the param- 
eter is substituted. Positional parameters may not be assigned to in 
this way. 

${parameter:?word} 


If parameter is set and is non-null, substitute its value; otherwise, 
print word and exit from the shell. If word is omitted, the message 
“parameter null or not set” is printed. 


${parameter:+word} 


If parameter is set and is non-null, substitute word; otherwise substi- 
tute nothing. 


In the above, word is not evaluated unless it is to be used as the substituted 
string. For example, in the following command pwd is executed only if dis 
not set or is null: 


echo ${d:— pwd*} 


If the colon (:) is omitted from the above expressions, the shell checks only 
whether parameter is set. 


The following parameters are automatically set by the shell: 
# The number of positional parameters in decimal. 
- Flags supplied to the shell on invocation or by the set command. 


? The decimal value returned by the last synchronously executed com- 
mand. 
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$ The process number of this shell. 
! The process number of the last background command invoked. 
The following parameters are used by the shell: 


HOME The default argument (home directory) for the ed command. 

PATH The search path for commands (see Execution below). The 
user may not change PATH if executing under rsh. 

CDPATH The search path for the cd command. 

MAIL If this parameter is set to the name of a mail file and the MAIL- 


PATH parameter is not set, the shell informs the user of the 
arrival of mail in the specified file. 


MAILCHECK This parameter specifies how often (in seconds) the shell 
checks for the arrival of mail in the files specified by the MAIL- 
PATH or MAIL parameters. The default value is 600 seconds 
(10 minutes). If set to 0, the shell checks before each prompt. 


MAILPATH Acolon (:) separated list of filenames. If this parameter is set, 
the shell informs the user of the arrival of mail in any of the 
specified files. Each filename can be followed by % and a mes- 
sage that will print when the modification time changes. The 
default message is you have mail. 


PSL Primary prompt string, by default “$ ”. 

PS2 Secondary prompt string, by default “> ”. 

IFS Internal field separators, normally space, tab, and newline. 
SHACCT If this parameter is set to the name of a file writable by the 


user, the shell will write an accounting record in the file for 
each shell procedure executed. 


SHELL When the shell is invoked, it scans the environment (see Envi- 
ronment) for this name. If it is found and rsh is the filename 
part of its value, the shel] becomes a restricted shell. 


The shell gives default values to PATH, PSi, PS2, MAILCHECK and IFS. 
HOME and MAIL are set by login(1). 


Blank Interpretation 


After parameter and command substitution, the results of substitution are 
scanned for internal field separator characters (those found in IFS) and split 
into distinct arguments where such characters are found. Explicit null argu- 
ments (""or °’) are retained. Implicit null arguments (those resulting from 
parameters that have no values) are removed. 


Input/Output 


Acommand’s input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple-com- 
mand or may precede or follow a command and are not passed on as argu- 
ments to the invoked command. Note that parameter and command substitu- 
tion occurs before word or digit is used. 


<word Use file word as standard input (file descriptor 0). 
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>word Use file word as standard output (file descriptor 1). If the file 
does not exist it is created. Otherwise, it is truncated to zero 
length. 

>>word Use file word as standard output. If the file exists, output is 

appended to it (by first seeking to the end-of-file). Otherwise, the 
file is created. 

<<[-]Jword After parameter and command substitution is done on word, the 
shell input is read up to the first line that literally matches the 
resulting word, or to an end-of-file. If, however, - is appended to 
<<, the following occurs: 


1) Leading tabs are stripped from word before the shell input is 
read (but after parameter and command substitution is done 
on word). 

2) Leading tabs are stripped from the shell input as it is read 
and before each line is compared with word. 

8) Shell input is read up to the first line that literally matches 
the resulting word, or to an end-of-file. 

If any character of word is quoted (see Quoting, later), no addi- 

tional processing is done to the shell input. If no characters of 

word are quoted, the following takes place: 


1) Parameter and command substitution occurs. 

2) (Escaped) \newline is ignored. 

3) \ must be used to quote the characters \, $, and. 
The resulting document becomes the standard input. 


<&digit Use the file associated with file descriptor digit as standard 
input. Similarly for the standard output using >&digit. 


<&- The standard input is closed. Similarly for the standard output 
using >&-. : 

If any of the above is preceded by a digit, the file descriptor which will be asso- 

ciated with the file is that specified by the digit (instead of the default 0 or 1). 

For example, the following line associates file descriptor 2 with the file cur- 

rently associated with file descriptor 1. 


‘vas Q>&1 


The order in which redirections are specified is significant. The shell evalu- 
ates redirections left-to-right. For example, the following line first associates 
file descriptor 1 with file xxx. It associates file descriptor 2 with the file asso- 
ciated with file descriptor 1 (i.e., xxx). 


l>xxx 2>61 


If the order of redirections were reversed, file descriptor 2 would be associated 
with the terminal (assuming file descriptor 1 had been) and file descriptor 1 
would be associated with file xx. 


Using the terminology introduced under Commands on the first page, ifa 
command is composed of several simple commands, redirection will be 
evaluated for the entire command before it is evaluated for each simple 
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command. That is, the shell evaluates redirection for the entire list, then each 
pipeline within the list, then each command within each pipeline, then each =) 
list within each command. 


If a command is followed by &, the default standard input for the command is 
the empty file /dev/null. Otherwise, the environment for the execution of a 
command contains the file descriptors of the invoking shell as modified by 
input/output specifications. 


Redirection of output is not allowed in the restricted shell. 


Filename Generation 


Quoting 


Before a command is executed, each command word is scanned for the charac- 
ters *, ?, and[. If one of these characters appears, the word is regarded asa 
pattern. The word is replaced with alphabetically sorted filenames that match 
the pattern. If no filename is found that matches the pattern, the word is left 
unchanged. The character . at the start of a filename or immediately follow- 
ing a/, as well as the character / itself, must be matched explicitly. 


* Matches any string, including the null string. 
eg Matches any single character. 


[...] Matches any one of the enclosed characters. A pair of characters 
separated by - matches any character lexically between the pair, 
inclusive. If the first character following the opening [ is a exclama- 
tion mark (!), any character not enclosed is matched. 


The following characters have a special meaning to the shell and cause termi- 
nation of a word unless quoted: 


; &() | * <> newline space tab 


Acharacter may be quoted (i.e., made to stand for itself) by preceding it with a 
backslash (\) or inserting it between a pair of quote marks (*’ or '""). During 
processing, the shell may quote certain characters to prevent them from tak- 
ing on a special meaning. Backslashes used to quote a single character are 
removed from the word before the command is executed. The pair \newline is 
removed from a word before command and parameter stibstitution. 


All characters enclosed between a pair of single quote marks (“*), except a 
single quote, are quoted by the shell. Backslash has no special meaning inside 
a pair of single quotes. A single quote may be quoted inside a pair of double 
quote marks (for example, "“"). 


Inside a pair of double quotes (""), parameter and command substitution 
occurs and the shell quotes the results to avoid blank interpretation and 
filename generation. If $+ is within a pair of double quotes, the positional 
parameters are substituted and quoted, separated by quoted spaces ("$1 $2 
..."). However, if $@ is within a pair of double quotes, the positional parame- 
ters are substituted and quoted, separated by unquoted spaces ("$1""$2" ... ). 
\ quotes the characters \,*,", and $. The pair \newline is removed before 
parameter and command substitution. Ifa backslash precedes characters 
other than \, *, ", $, and newline, then the backslash itself is quoted by the 
shell. 
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Prompting 
@ When used interactively, the shell prompts with the value of PS1 before read- 


ing a command. If at any time a newline is typed and further input is needed 
to complete a command, the secondary prompt (i.e., the value of PS2) is issued. 


Environment 


The environment (see environ(5)) is a list of name-value pairs that is passed 
to an executed program in the same way as a normal argument list. The shell 
interacts with the environment in several ways. On invocation, the shell 
scans the environment and creates a parameter for each name found, giving it 
the corresponding value. If the user modifies the value of any of these param- 
eters or creates new parameters, none of these affects the environment unless 
the export command is used to bind the shell’s parameter to the environment 
(see also set -a). A parameter may be removed from the environment with 
the unset command. The environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally inherited by the 
shell, minus any pairs removed by unset, plus any modifications or additions, 
all of which must be noted in export commands. 


The environment for any simple-command may be augmented by prefixing it 
with one or more assignments to parameters. Thus, the following lines are 
equivalent (as far as the execution of cmd is concerned). 


TERM=450 cmd 
and 
(export TERM; TERM=450; cmd) 


If the —-k flag is set, all keyword arguments are placed in the environment, 
even if they occur after the command name. The following first prints a=b c 
and c: 


echo a=b c 
set -—k 
echo a=b c 


Signals 


The INTERRUPT and QUIT signals for an invoked command are ignored if the 
command is followed by &; otherwise signals have the values inherited by the 
shell from its parent, with the exception of signal 11 (see the trap command). 


Execution 
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Each time a command is executed, the above substitutions are carried out. If 
the command name matches one of the Special Commands listed below, it is 
executed in the shell process. If the command name does not match a Special 
Command but matches the name of a defined function, the function is exe- 
cuted in the shell process (note how this differs from the execution of shell pro- 
cedures). The positional parameters $1, $2, .... are set to the arguments of 
the function. If the command name matches neither a Special Command nor 
the name of a defined function, a new process is created and an attempt is 
made to execute the command via exec(2). 


The shell parameter PATH defines the search path for the directory contain- 
ing the command. Alternative directory names are separated by a colon (:). 
The default path is :/bin:/ usr/bin (specifying the current directory, /bin, and 
/usr/bin, in that order). The current directory is specified by a null path- 
name, which can appear immediately after the equal sign, between two colon 
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mand name contains a /, the search path is not used; such commands will not 
be executed by the restricted shell. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission but is not an 
a.out file, it is assumed to be a file containing shell commands. A sub-shell is 
spawned to read it. A parenthesized command is also executed in a sub-shell. 


delimiters anywhere in the path list, or at the end of the path list. If the com- @ 
Ss 


The location in the search path where a command was found is remembered 
by the shell (to avoid unnecessary execs later). If the command was found in 
a relative directory, its location must be re-determined whenever the current 
directory changes. The shell forgets all remembered locations whenever the 
PATH variable is changed or the hash -r command is executed (see below). 


Special Commands 


Input/output redirection is now permitted for these commands. File descriptor 
lis the default output location. 
t No effect; the command does nothing. A zero exit code is returned. 


. file Read and execute commands from file and return. The search path 
specified by PATH is used to find the directory containing file. 


break [7 ] 
Exit from the enclosing for or while loop, if any. Ifn is specified 


break n levels. 
continue [7 ] 
Resume the next iteration of the enclosing for or while loop. If n is 
specified resume at the n-th enclosing loop. @ 


ed[ arg ] 
Change the current directory to arg. The shell parameter HOME is 
the default arg. The shell parameter CDPATH defines the search path 
for the directory containing arg. Alternative directory names are 
separated by acolon. The default path is <null> (specifying the cur- 
rent directory). Note that the current directory is specified by a null 
pathname, which can appear immediately after the equal sign or 
between the colon delimiters anywhere else in the path list. Ifarg 
begins with a/the search path is not used. Otherwise, each directory 
in the path is searched for arg. rsh cannot execute the cd command. 


echo[ arg... ] 
Echo arguments. See echo(1) for usage and description. 


eval [ arg... ] 
The arguments are read as input to the shell and the resulting com- 


mand(s) executed. 


exec[ arg... ] 
The command specified by the arguments is executed in place of this 
shell without creating a new process. Input/output arguments may 
appear and, if no other arguments are given, cause the shell input/out- 
put to be modified. 


exit[ xn ] 
Causes a shell to exit with the exit status specified by n. Ifn is omit- @ 
ted the exit status is that of the last command executed (an end-of-file - 
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will also cause the shell to exit). 


export [ name... ] 


The given names are marked for automatic export to the environment 
of subsequently-executed commands. If no arguments are given, vari- 
able names that have been marked for export during the current 
shell’s execution are listed. (Variable names exported from a parent 
shell are listed only if they have been exported again during the cur- 
rent shell’s execution.) Function names are not exported. 


getopts 


Use in shell scripts to support command syntax standards (see 
intro(1)); it parses positional parameters and checks for legal options. 
See getopts(1) for usage and description. 


hash [ -r J[ name... ] 


For each name, the location in the search path of the command speci- 
fied by name is determined and remembered by the shell. The -r 
option causes the shell to forget all remembered locations. If no argu- 
ments are given, information about remembered commands is 
presented. Hits is the number of times a command has been invoked 
by the shell process. Cost is a measure of the work required to locate a 
command in the search path. If a command is found in a “relative” 
directory in the search path, after changing to that directory, the 
stored location of that command is recalculated. Commands for which 
this will be done are indicated by an asterisk (*) adjacent to the hits 
information. Cost will be incremented when the recalculation is done. 


newgrp[ arg... ] 


pwd 


Equivalent to exec newgrp arg .... See newgrp(1) for usage and 
description. 

Print the current working directory. See pwd(1) for usage and 
description. 


read[ name... ] 


One line is read from the standard input and, using the internal field 
separator IFS (normally space or tab) to delimit word boundaries, the 
first word is assigned to the first name, the second word to the second 
name, etc., with leftover words assigned to the last name. Lines can 
be continued by using \newline. Characters other than newline can 
be quoted by preceding them with a backslash. These backslashes are 
removed before words are assigned to names, and no interpretation is 
done on the character that follows the backslash. The return code is 0 
unless an end-of-file is encountered. 


readonly [ name... ] 


The given names are marked readonly and the values of these names 
may not be changed by subsequent assignment. If no arguments are 
given, a list of all readonly names is printed. 


return[ 7 ] 


Causes a function to exit with the return value specified by n. Ifn is 
omitted, the return status is that of the last command executed. 
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set [ —aefhkntuvx [ arg... ]] 


-a Mark variables which are modified or created for export. 
-e Exit immediately ifa command exits with a non-zero exit status. 
-f Disable filename generation. 


-h_ Locate and remember function commands as functions are 
defined (function commands are normally located when the func- 
tion is executed). 


-k All keyword arguments are placed in the environment for a com- 
mand, not just those that precede the command name. 


-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-v Print shell input lines as they are read. 

-x Print commands and their arguments as they are executed. 
-- Donot change any of the flags; useful in setting $1 to -. 


Using rather than - causes these flags to be turned off. These flags 


can also be used upon invocation of the shell. The current set of flags 
may be found in $-. The remaining arguments are positional param- 
eters and are assigned, in order, to $1, $2,.... Ifno arguments are 
given the values of all names are printed. 


shift [ n ] 


test 


times 


The positional parameters from $n+1... are renamed $1.... Ifn is 
not given, it is assumed to be 1. 


Evaluate conditional expressions. See test(1) for usage and descrip- 
tion. 

Print the accumulated user and system times for processes run from 
the shell. 


trap [arg ][7n ]... 


The command arg is to be read and executed when the shell receives 
signal(s)n. (Note that arg is scanned once when the trap is set and 
once when the trap is taken.) Trap commands are executed in order 
of signal number. Any attempt to set a trap on a signal that was 
ignored on entry to the current shell is ineffective. An attempt to 
trap on signal 11 (memory fault) produces an error. If arg is absent, 
all trap(s) n are reset to their original values. If arg is the null string 
this signal is ignored by the shell and by the commands it invokes. If 
n is 0, the command arg is executed on exit from the shell. The trap 
command with no arguments prints a list of commands associated 
with each signal number. 


type[ name... ] 


For each name, indicate how it would be interpreted if used as a com- 
mand name. 


ulimit [7 ] 


10 


Impose a size limit of n blocks on files written by the shell and its 
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child processes (files of any size may be read). If n is omitted, the cur- 
rent limit is printed. You may lower your own ulimit, but only a 
superuser (see su(1M)) can raise a ulimit. 
umask [ nnn J 
The user file-creation mask is set to nnn (see umask(1)). If nnn is 
omitted, the current value of the mask is printed. 
unset [ name... ] 
For each name, remove the corresponding variable or function. The 
variables PATH, PS1, PS2, MAILCHECK and IFS cannot be unset. 
wait[n ] 
Wait for your background process whose process ID is n and report 
its termination status. Ifn is omitted, all your shell’s currently 
active background processes are waited for and the return code will 
be zero. 
Invocation 
If the shell is invoked through exec(2) and the first character of argument 
zero is -, commands are initially read from /etc/ profile and from $HOME/ -pro- 
file, if such files exist. Thereafter, commands are read as described below, 
‘ which is also the case when the shell is invoked as /bin/sh. The flags below 
are interpreted by the shell on invocation only. Note that unless the -c or —s 
flag is specified, the first argument is assumed to be the name of a file contain- 


ing commands, and the remaining arguments are passed as positional param- 
eters to that command file. 


-c string If the -c flag is present, commands are read from string. 


-s If the -s flag is present or if no arguments remain, commands are 
read from the standard input. Any remaining arguments specify 
the positional parameters. Shell output (except for Special Com- 
mands) is written to file descriptor 2. 


-i If the -i flag is present or if the shell input and output are attached 
to a terminal, this shell is interactive. In this case TERMINATE is 
ignored (so that kill 0 does not kill an interactive shell) and INTER- 
RUPT is caught and ignored (so that wait is interruptible). In all 
cases, QUIT is ignored by the shell. 


-r If the -r flag is present, the shell is a restricted shell. 


The remaining flags and arguments are described under the set command. 
rsh Only 


rsh is used to set up login names and execution environments whose capabili- 
ties are more controlled than those of the standard shell. The actions of rsh 
are identical to those of sh, except that the following are disallowed: 


Changing directory (see ed(1)) 
Setting the value of $PATH 
Specifying path or command names containing / 
Redirecting output (> and >>) 
The restrictions above are enforced after .profile is interpreted. 
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A restricted shell can be invoked in one of the following ways: 


(1) | rshis the filename part of the last entry in the /etc/passwd file (see 
passwd(4)). 


(2) The environment variable SHELL exists and rsh is the filename part of 
its value. 


(3) The shell is invoked and rsh is the filename part of argument 0. 
(4) | The shell is invoked with the -r option. 


When a command to be executed is found to be a shell procedure, rsh invokes 
sh to execute it. Thus, it is possible to provide to the end-user shell proce- 
dures that have access to the full power of the standard shell, while imposing 
a limited menu of commands. This scheme assumes that the end-user does 
not have write and execute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile (see profile(4)) 
has complete control over user actions by performing guaranteed setup 
actions and leaving the user in an appropriate directory (probably not the 
login directory). 

The system administrator often sets up a directory of commands (such as 
/usr/rbin) that can be safely invoked by a restricted shell. Some systems also 
provide a restricted editor, red. 


PARALLEL SUPPORT 
sh manages the creation of command lists terminated with an ampersand in a 
manner similar to parallel make(1). The environment variable PARALLEL is 
used to determine the number of commands lists to be run concurrently. if 
PARALLEL is not set, sh will always attempt to run the command list. 


FILES 
/etc/profile 
$HOME/.profile 
/tmp/sh* 
/dev/null 


SEE ALSO 
ced(1), echo(1), env(1), getopts(1), intro(1), login(1), newgrp(1), pwd(1), test(1), 
umask(1), wait(1), dup(2), exec(2), fork(2), pipe(2), signal(2), ulimit(2), profile(4) 
DIAGNOSTICS 
Errors detected by the shell, such as syntax errors, cause the shell to return a 
non-zero exit status. Ifthe shell is being used non-interactively execution of 
the shell file is abandoned. Otherwise, the shell returns the exit status of the 
last command executed (see also the exit command above). 


NOTES 
Words used for filenames in input/output redirection are not interpreted for 
filename generation (see Filename Generation). For example, cat filel >a* 
will create a file named a*. 


Because commands in pipelines are run as separate processes, variables set in 
a pipeline have no effect on the parent shell. 


If you get the error message cannot fork, too many processes , try using the 
wait(1) command to clean up your background processes. If this doesn’t help, 
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BUGS 
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the system process table is probably full or you have too many active fore- 
ground processes. (There is a limit to the number of process ids associated 
with your login, and to the number the system can keep track of.) 


If a command is executed and a command with the same name is installed ina 
directory in the search path before the directory where the original command 
was found, the shell will continue to exec the original command. Use the 
hash command to correct this situation. 


If you move the current directory or one above it, pwd may not give the cor- 
rect response. Use the cd command with a full pathname to correct this situ- 
ation. 


Not all the processes of a 3- or more-stage pipeline are children of the shell, 
and thus cannot be waited for. 


For wait n, ifn is not an active process id, all your shell’s currently active 
background processes are waited for and the return code will be zero. 
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NAME 

shell — run a command using shell 
SYNOPSIS 

shell command [command ...] 
DESCRIPTION 


The shell built-in takes each of its arguments, puts them together separated 
by a space, and passes this command to the operating system shell ($SHELL if 
set, otherwise /bin/sh). 


EXAMPLES 
Since the Interpreter doesn’t support background processing, the shell 
built-in can be used instead. 


‘shell "build prog &"* 
Using test(1) can be useful. This example tests to see if field 2 of a formisa 


file. 
valid=‘shell test -f $F2‘ 
SEE ALSO 
sh(1), test(1) 
WARNINGS 


The arguments are concatenated using spaces, which may or may not do what 
is expected. The variables set in local environments are not expanded by the 
shell because local means local to the current process. 
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NAME 
© showcefg — show the configuration of the machine 


SYNOPSIS . 
letc/showefg [ -« | -d ] 


DESCRIPTION 
showcfg displays the configuration of the system in a manner similar to the 
re command of the SCED power-up monitor and the config command of the 
SSM power-up monitor. 


The -s flag selects an alternate one-line format that gives the quantity of each 
type of board. 
The —d flag produces a dump of relevant parts of the system’s configuration 
description table. The data displayed includes information about the memory 
available, the boot flags, the boot device, console tty control characters, and 
the current system bus mode. 

FILES 
/dev/kmem 

SEE ALSO 
dmesg(1M) 
/usr/adm/messages 

BUGS 
Boards on the MULTIBUS or VMEBUS are riot currently displayed. 


@ 
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© NAME 


shutdown — shut down system, change system state 


SYNOPSIS 


/ete/shutdown [ -y ] [ -ggrace_period ] [ -iinit_state ] 


DESCRIPTION 


@ SEE ALSO 


This command is executed by the superuser to change the state of the 
machine. By default, it brings the system to a state where only the console 
has access to the operating system. This state is traditionally called single- 
user. 


The command sends a warning message and a final message before it starts 
actual shutdown activities. By default, the command asks for confirmation 
before it starts shutting down daemons and killing processes. The options are 
used as follows: 


~-y Pre-answers the confirmation question so the command can be run 
without user intervention. A default of 60 seconds is allowed between 
the warning message and the final message. Another 60 seconds is 
allowed between the final message and the confirmation. 


—ggrace_period 
Allows the superuser to change the number of seconds from the 60-sec- 
ond default. 


-iinit_state 
Specifies the state that init(1M) is to be put in following the warnings, 
if any. By default, system state s is used (the same as states land S). 


Other recommended system state definitions are as follows: 


state 0 
Shut the machine down so it is safe to remove the power. Have the 
machine remove power if it can. The /etc/rcO procedure is called to do 
this work. 


state 1,s,S . 
Bring the machine to the state traditionally called single-user. The 
/etc/rc0 procedure is called to do this work. (Though s and 1 are both 
used to go to single-user state, s only kills processes spawned by init and 
does not unmount filesystems. State 1 unmounts everything except root 
and kills all user processes, except those that relate to the console.) 


state 5 
Stop the operating system and go to the firmware monitor. 


state 6 
Stop the operating system and reboot to the state defined by the initde- 
fault entry in /etc/inittab. Reboot occurs only if the AUTO button on 
the front of the machine is pushed (i.e. autobooting is enabled). If auto- 
‘ booting is not enabled, the operating system is stopped and goes to the 
firmware monitor (same as state 5). 


init(1M), rc0(1M), rc2(1M), inittab(4) 
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NAME 
sleep — suspend execution for an interval 
SYNOPSIS 
sleep time 
DESCRIPTION 
sleep suspends execution for time seconds. It is used to execute a command 
after a certain amount of time, as in the following example: 
(sleep 105; command) & 
It can also execute a command at specified times, as in the next example: 
while true 
do 
command 
sleep 37 
done 
SEE ALSO 
alarm(2), sleep(3C) 
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sort — sort and/or merge files 


SYNOPSIS 
sort [-cmu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnr] [-btx] 
[+pos1 [-pos2]] [files] 

DESCRIPTION 
sort sorts lines of all the named files together and writes the result on the 
standard output. The standard input is read if -is used as a filename or no 
input files are named. 


Comparisons are based on one or more sort keys extracted from each line of 
input. By default, there is one sort key (the entire input line) and ordering is 
lexicographic by bytes in machine collating sequence. 


The following options alter the default behavior: 


-c 


—zrecsz 


Check that the input file is sorted according to the ordering rules; 
give no output unless the file is out of sort. 


Merge only, the input files are already sorted. 
Unique: suppress all but one in each set of lines having equal keys. 


The argument given is the name of an output file to use instead of 
the standard output. This file may be the same as one of the 
inputs. There may be optional blanks between -o and output. 


The amount of main memory used by the sort has a large impact on 
its performance. Sorting a small file in a large amount of memory 
is a waste. If this option is omitted, sort begins using a system 
default memory size, and continues to use more space as needed. If 
this option is presented with a value, kmem, sort will start using 
that number of kilobytes of memory, unless the administrative 
minimum or maximum is violated, in which case the corresponding 
extremum will be used. Thus, -y0 is guaranteed to start with mini- 
mum memory. By convention, -y (with no argument) starts with 
maximum memory. 


The size of the longest line read is recorded in the sort phase so buf- 
fers can be allocated during the merge phase. Ifthe sort phaseis _~ 
omitted via the -c or -m options, a popular system default size will 
be used. Lines longer than the buffer size will cause sort to termi- 
nate abnormally. Supplying the actual number of bytes in the 
longest line to be merged (or some larger value) will prevent abnor- 
mal termination. 


The following options override the default ordering rules: 


-d “Dictionary” order: only letters, digits, and blanks (spaces and tabs) are 
significant in comparisons. 

-f Fold lowercase letters into uppercase. 

-i Ignore non-printable characters. 


-M_ Compare as months. The first three non-blank characters of the field are 
folded to uppercase and compared. For example, in English the sorting 
order is "JAN" < "FEB" <...< "DEC". Invalid fields compare low to "JAN". 
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The ~M option implies the —b option (see below). 

-n An initial numeric string, consisting of optional blanks, optional minus 
sign, and zero or more digits with optional decimal point, is sorted by 
arithmetic value. The —n option implies the —b option (see below). Note 
that the -b option is effective only when restricted sort key specifications 
are in effect. 


-r Reverse the sense of comparisons. 


When ordering options appear before restricted sort key specifications, the 
requested ordering rules are applied globally to all sort keys. When attached 
to a specific sort key (described below), the specified ordering options override 
all global ordering options for that key. 


The notation +pos1 -pos2 restricts a sort key to one beginning at pos] and 
ending just before pos2. The characters at position posi and just before pos2 
are included in the sort key (provided that pos2 does not precede pos1). A 
missing -pos2 means the end of the line. 


Specifying pos1 and pos2 involves the notion of a field, a minimal sequence of 
characters followed by a field separator or a newline. By default, the first 
blank (space or tab) of a sequence of blanks acts as the field separator. All 
blanks in a sequence of blanks are considered to be part of the next field. For 
example, all blanks at the beginning of a line are considered to be part of the 
first field. The treatment of field separators can be altered by using these 
options: : 

-b Ignore leading blanks when determining the starting and ending posi- 
tions of a restricted sort key. If the —b option is specified before the first 
+pos1 argument, it will be applied to all +pos1 arguments. Otherwise, 
the b flag may be attached independently to each +pos1 or ~pos2 argu- 
ment (see below). 


-tx Use x as the field separator character. x is not considered to be part of a 
field (although it may be included in a sort key). Each occurrence of x is 
significant (for example, xx delimits an empty field). 


Posi and pos? each have the form m.n optionally followed by one or more of 
the flags bdfinr. A starting position specified by +m.n is interpreted to mean 
the n+1st character in the m+Ist field. A missing .n means .0, indicating the 
first character of the m-+1st field. If the b flag is in effect, n is counted from 
the first nen-blank in the m+1st field; +m.0b refers to the first non-blank 
character in the m+1st field. 


A last position specified by -m.n is interpreted to mean the nth character 
(including separators) after the last character of the mth field. A missing .n 
means .0, indicating the last character of the mth field. If the b flag is in 
effect, n is counted from the last leading blank in the m+1st field; -m.1b 
refers to the first non-blank in the m-+l1st field. 


When there are multiple sort keys, later keys are compared only after all ear- 
lier keys compare equal. Lines that otherwise compare equal are ordered with 
all bytes significant. 
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© EXAMPLES 


FILES 


Sort the contents of infile with the second field as the sort key: 
sort +1 -2 infile 


Sort, in reverse order, the contents of infileI and infile2, placing the output in 
outfile and using the first character of the second field as the sort key: 


sort -r -o outfile +1.0 -1.2 infilel infile2 


Sort, in reverse order, the contents of infile1 and infile2 using the first non- 
blank character of the second field as the sort key: 


sort -r +1.0b-1.1binfilel infile2 


Print the password file (passwd(4)) sorted by the numeric user ID (the third 
colon-separated field): 


sort -t: +2n -3 /etc/passwd 


Print the lines of the already sorted file infile, suppressing all but the first 
occurrence of lines having the same third field (the options -um with just one 
input file make the choice of a unique representative from a set of equal lines 
predictable): 


sort -um +2 -3 infile 


/usr/tmp/stm??? 


SEE ALSO 


@ WARNINGS 
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comm(1), join(1), uniq(1) 


Comments and exits with non-zero status for various trouble conditions (for 
example, when input lines are too long), and for disorder discovered under the 
-c option. When the last line of an input file is missing a newline character, 
sort appends one, prints a warning message, and continues. 


sort does not guarantee preservation of relative line ordering on equal keys. 
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NAME 
@ spell, hashmake, spellin, hashcheck — find spelling errors 


SYNOPSIS 
spell [-v ][-b ] [-x ][-1] [ +local_file ] [ files ] 


/usr/lib/spell/hashmake 
/usr/lib/spell/spellin n 
/usr/lib/spell/hashcheck spelling_list 


DESCRIPTION 
spell collects words from the named files and looks them up in a spelling list. 
Words that do not occur among or are not derivable (by applying certain 
inflections, prefixes, and/or suffixes) from words in the spelling list are printed 
on the standard output. If no files are named, words are collected from the 
standard input. 


spell ignores most tbl(1) and eqn(1) constructions. 


Under the -v option, all words not literally in the spelling list are printed and 
plausible derivations from the words in the spelling list are indicated. 


Under the -b option, British spelling is checked. Besides preferring centre, 
colour, programme, speciality, travelled, etc., this option insists upon -ise in 
words like standardise, Fowler and the OED to the contrary notwithstanding. 


Under the —x option, every plausible stem is printed with = for each word. 


By default, spell (ike deroff(1)) follows chains of included files (.s0 requests) 
unless the names of such included files begin with /usr/lib. Under the -1 
option, spell will follow the chains of all included files. 


Under the +local_file option, words found in local_file are removed from spell’s 
output. Local_file is the name of a user-provided file that contains a sorted list 
of words, one per line. With this option, the user can specify a set of words 
that are correct spellings (in addition to spell’s own spelling list) for each job. 


The spelling list is based on many sources, and while more haphazard than an 
ordinary dictionary, is also more effective with respect to proper names and 
popular technical words. Coverage of the specialized vocabularies of biology, 
medicine, and chemistry is light. 


Pertinent auxiliary files may be specified by name arguments, indicated below 
with their default settings (see FILES). Copies of all output are accumulated in 
the history file. The stop list filters out misspellings (for example, 
thier=thy—y+ier) that would otherwise pass. 


Three routines help maintain and check the hash lists used by spell: 


hashmake Reads a list of words from the standard input and writes the cor- 
responding nine-digit hash code on the standard output. 


spellin Reads n hash codes from the standard input and writes a com- 
pressed spelling list on the standard output. 


hashcheck Reads a compressed spelling_list and recreates the nine-digit 
hash codes for all the words in it. hashcheck then writes these 
codes on the standard output. : 
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FILES 
D_SPELL=/usr/ib/spell/nlistfab] Hashed spelling lists, American & British & 
S_SPELL=/usr/lib/spell/hstop Hashed stop list 
H_SPELL=/usr/lib/spell/spellhist History file 
/usr/lib/spell/spellprog Program 
SEE ALSO 


BUGS 


deroff(1), sed(1), sort{(1), tee(1) 


eqn(1), tbl(1) in the DOCUMENTER’S WORKBENCH Technical Discussion and 
Reference Manual 


The spelling list’s coverage is uneven. New installations will probably wish to 
monitor the output for several months to gather local additions. Typically, 
these are kept in a separate local file that is added to the hashed spelling_list 
via spellin. 
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NAME 
@ ; spline — interpolate smooth curve 


SYNOPSIS 
spline [ options ] 

DESCRIPTION 
spline takes pairs of numbers from the standard input as abscissas and ordi- 
nates of a function. It produces a similar set (which is approximately equally 
spaced and includes the input set) on the standard output. The cubic spline 
output has two continuous derivatives and sufficiently many points to look 
smooth when plotted, for example by graph(1G). 


The following options are recognized, each as a separate argument: 


-a Supply abscissas automatically (they are missing from the input); 
spacing is given by the next argument, or is assumed to be 1 if next 
argument is not a number. 


-k The constant & used in the boundary value computation shown below 
is set by the next argument (default k = 0). 


Yo=RYi1, In =RhYn-1 


-n Space output points so that approximately n intervals occur between 
the lower and upper x limits (default n = 100). 
-p Make output periodic, i.e., match derivatives at ends. First and last 
input values should normally agree. 
© -x Next 1 (or 2) arguments are lower (and upper) x limits. Normally, 


these limits are calculated from the data. Automatic abscissas start 
at lower limit (default 0). 


SEE ALSO 
graph(1G) 
DIAGNOSTICS 
When data is not strictly monotone in x, spline reproduces the input without 
interpolating extra points. 
BUGS 
A limit of 1000 input points is enforced silently. 
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NAME 
split — split a file into pieces 

SYNOPSIS 
split [ -n ] [ file [ name ] ] 

DESCRIPTION 
split reads file and writes it in n-line pieces (default 1000 lines) onto a set of 
output files. The name of the first output file is name with aa appended, and 
so on lexicographically, up to zz (a maximum of 676 files). If no output name is 
given, x is default. 
If no input file is given or if -is given, then the standard input file is used. 


SEE ALSO 
bfs(1), csplit(1) 


12/89 


DYNIX/ptx STARTER(1) 
NAME 

starter — information about the operating system for beginning users 
SYNOPSIS 

[ help ] starter 
DESCRIPTION 

The Help Facility starter command provides information to assist new users: 

- Commands a new user should learn first 

- Local environment information 


The user can choose one of the above categories by entering its corresponding 
letter (given in the menu), or can exit to the shell by typing q (for quit"). 
When a category is chosen, the user will receive one or more pages of informa- 
tion pertaining to it. 

From any screen in the Help Facility, a user can execute a command via the 
shell by typing an exclamation mark (!) and the command to be executed. The 
screen will be redrawn if the command was entered at a first-level prompt. If 
entered at any other prompt level, only the prompt will be redrawn. 


By default, the Help Facility scrolls the data that is presented to the user. If 
you prefer to have the screen clear before printing the data (non-scrolling), the 
shell variable SCROLL must be set to no and exported so it will become part 
of your environment. This is done by adding the following line to your .profile 
file (see profile(4)): “export SCROLL ; SCROLL=no”. If you later decide that 
scrolling is desired, SCROLL must be set to yes. 


Information on each of the Help Facility commands (starter, locate, usage, 
glossary, and help) is located on their respective manual pages. 

SEE ALSO 
esh(1), glossary(1), help(1), locate(1), sh(1), usage(1), term(5) 

WARNINGS 


If the shell variable TERM is not set in the user’s .profile file, then TERM will 
default to the terminal value type 450 (a hard-copy terminal). For a list of 
valid terminal types, refer to term(5). 
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NAME 


stat — statistical network useful with graphical commands 


SYNOPSIS 


node-name [options] [files] 


DESCRIPTION 
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stat is a collection of command level functions (nodes) that can be intercon- 
nected using sh(1) to form a statistical network. The nodes reside in 
/usr/bin/graf (see graphics(1G)). Data is passed through the network as 
sequences of numbers (vectors), where a number is of the following form and is 
evaluated in the usual way. 


[sign](digits)(.digits)le[sign]digits] 


Brackets and parentheses surround fields. All fields are optional, but at least 
one of the fields surrounded by parentheses must be present. Any character 
input to a node that is not part of a number is taken as a delimiter. 


stat nodes are divided into four classes: 

Transformers Map input vector elements into output vector elements 
Summarizers Calculate statistics of a vector 

Translators Convert among formats 

Generators Sources of definable vectors 


Below is a list of synopses for stat nodes. Most nodes accept options indicated 
by a leading hyphen (-). In general, an option-is specified by a character fol- 
lowed by a value, such as c5. This is interpreted as c := 5 (c is assigned 5). 
The following keys are used to designate the expected type of the value: 

c Characters 

i Integer 

f Floating point or integer 

file Filename 


string String of characters surrounded by quotes to include a shell argu- 
ment delimiter. 

Options without keys are flags. All nodes except generators accept files as 

input, hence it is not indicated in the synopses. 


Transformers: 
abs [-ci] — Absolute value 
columns (similarly for -c options that follow) 
af [-ci tv ]—Arithmetic function 
titled output, verbose 
ceil [-ci]— Round up to next integer 
cusum__ [-ci] — Cumulative sum 
exp [-ci]-— Exponential 
floor [ei] — Round down to next integer 


gamma [-ci]—Gamma 
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list [-ei dstring ] — List vector elements 
delimiter(s) 

log [-ci bf] — Logarithm 
base 

mod [-ci mf] - Modulus 
modulus 

pair [-ci Ffile xi]— Pair elements 
File containing base vector, x group size 

power  [-ci pf]- Raise to a power 
power 

root [-ci rf ]-— Take a root 
root 

round _[-ci pi si ]— Round to nearest integer, .5 rounds to 1 
places after decimal point, significant digits 

siline [{-ci if nisf ]— Generate a line given slope and intercept 
intercept, number of positive integers, slope 

sin [-ci]- Sine 

subset [-afbf ci Ffile ii If nl np pf si ti] - Generate a subset 
above, below, File with master vector, interval, leave, master con- 
tains element numbers to leave, master contains element numbers 
to pick, pick, start, terminate 

Summarizers: 

bucket [-ai ci Ffile hf ii If ni] — Break into buckets 
average size, File containing bucket boundaries, high, interval, 
low, number 
Input data should be sorted 

cor [-Ffile ]— Correlation coefficient 
File containing base vector 

hilo [-h 10 ox oy } Find high and low values 
high only, low only, option form, option form with x prepended, 
option form with y prepended 

lreg [-Ffile io s ]— Linear regression 
File containing base vector, intercept only, option form for siline, 
slope only 

mean [-ff ni pf ]- (Trimmed) arithmetic mean 
fraction, number, percent 

point {-ff ni pfs ]— Point from empirical cumulative density function 
fraction, number, percent, sorted input 

prod — Internal product 

qsort [-ci] — Quick sort 

rank — Vector rank 

total —Sum total 
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var — Variance 
Translators: 
bar [-a b f g ri wi xf xa yf ya ylf yhf ]— Build a bar chart 


label 


pie 


plot 


title 


Generators: 


gas 
prime 
rand 


WARNINGS 


Suppress axes, bold, suppress frame, suppress grid, region, 
width in percent, x origin, suppress x-axis label, y origin, 
suppress y-axis label, y-axis lower bound, y-axis high bound 
Data is rounded off to integers. 


[-a b f g ri xf xa yf ya ylf yhf ]- Builda histogram 
Suppress axes, bold, suppress frame, suppress grid, region, x 
origin, suppress x-axis label, y origin, suppress y-axis label, 
y-axis lower bound, y-axis high bound 


[-b c Ffile h pri x xuy yr ]— Label the axis of a GPS file 
bar chart input, retain case, label File, histogram input, plot 
input, rotation, x-axis, upper x-axis, y-axis, right y-axis 


[-b 0 p pni ppi ri v xi yi ]— Build a pie chart 

bold, values outside pie, value as percentage(:=100), value as 
percentage(:=i), draw percent of pie, region, no values, x ori- 
gin, y origin 

Unlike other nodes, input is lines of the form: 


[< ie fcc >] value [label] 
ignore (do not draw) slice, explode slice, fill slice, color 
slice c=( black, red, green, blue) 


[-a b estring d f Ffile g m ri xf xa xif xhf xlf xni xt yf ya 
yif yhf ylf yni yt ]— Plot a graph 

Suppress axes, bold, plotting characters, disconnected, sup- 
press frame, File containing x vector, suppress grid, mark 
points, region, x origin, suppress x-axis label, x interval, x 
high bound, x low bound, number of ticks on x-axis, suppress 
x-axis title, y origin, suppress y-axis label, y interval, y high 
bound, y low bound, number of ticks on y-axis, suppress 
y-axis title 

[-b c lstring vstring ustring ]— Title a vector or a GPS 

title bold, retain case, lower title, upper title, vector title 


[-ci if ni sf tf ]— Generate additive sequence 
interval, number, start, terminate 

[-ci hi li ni ]— Generate prime numbers 

high, low, number 

[-ci hf lf mf ni si]— Generate random sequence 
high, low, multiplier, number, seed 


Some nodes have a limit on the size of the input vector. 


SEE ALSO 


graphics(1G), gps(4) 
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NAME 
strace — print STREAMS trace messages 


SYNOPSIS 
strace [ mid sid level ] ... 


DESCRIPTION 
strace without arguments writes all STREAMS event trace messages from all 
drivers and modules to its standard output. These messages are obtained 
from the STREAMS log driver [log(7)]. If arguments are provided, they must 
be in triplets of the form mid, sid, level, where mid is a STREAMS module ID 
number, sid is a sub-id number, and evel is a tracing priority level. Each trip- 
let indicates that tracing messages are to be received from the given 
module/driver, sub-id (usually indicating minor device), and priority level 
equal to or less than the given level. The token all may be used for any mem- 
ber to indicate no restriction for that attribute. 
The format of each trace message output is as follows: 
<seq> <time> <ticks> <level> <flags> <mid> <sid> <text> 
<seq> Trace sequence number 
<time> Time of message in hh:mm:ss 
<ticks> Time of message in machine ticks since boot 
<level> Tracing priority level 


<flags> E: message is also in the error log 
F : indicates a fatal error 
N : mail was sent to the system administrator 


<mid> Module ID number of source 

<sid> Sub-id number of source 

<text> Formatted text of the trace message 

Once initiated, strace will continue to execute until terminated by the user. 


EXAMPLES 
Output all trace messages from the module or driver whose module ID is 41: 


strace 41all all 
Output those trace messages from driver/module ID 41 with sub-ids 0, 1, or 2: 
strace 4101 4111 4120 


Messages from sub-ids 0 and 1 must have a tracing level less than or equal to 
1. Those from sub-id 2 must have a tracing level of 0. 


SEE ALSO 
log(7) 

WARNINGS 
Due to performance considerations, only one strace process is permitted to 
open the STREAMS log driver at a time. The log driver has a list of the triplets 
specified in the command invocation, and compares each potential trace mes- 
sage against this list to decide if it should be formatted and sent up to the 
strace process. Hence, long lists of triplets will have a greater impact on 
overall STREAMS performance. Running strace will have the most impact on 
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sent to the strace process. If trace messages are generated faster than the 
strace process can handle them, then some of the messages will be lost. This 
last case can be determined by examining the sequence numbers on the trace 


messages output. 


the timing of the modules and drivers generating the trace messages that are 
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NAME 
strclean — STREAMS error logger cleanup program 

SYNOPSIS 
strclean [ -d logdir ] [-a age ] 

DESCRIPTION 
strclean is used to clean up the STREAMS error logger directory on a regular 
basis (for example, by using cron(1M)). By default, all files with names 
matching error.* in /usr/adm/streams that have not been modified in the last 
8 days are removed. A directory other than /usr/adm/streams can be speci- 
fied using the -d option. The maximum age in days for a log file can be 
changed using the ~a option. 

EXAMPLE 
The following command has the same result as running strelean with no 
arguments. 


strclean -d /usr/adm/streams -a 3 


FILES 
/usr/adm/streams/error.* 


SEE ALSO 
cron(1M), strerr(1M) 


NOTES 
strclean is typically run from cron(1M) on a daily or weekly basis. 
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NAME 


strerr — STREAMS error logger daemon 


SYNOPSIS 


strerr 


DESCRIPTION 


strerr receives error log messages from the STREAMS log driver [log(7)] and 
appends them to a log file. The error log files produced reside in the directory 
/usr/adm/streams and are named error.mm-dd, where mm is the month and 
dd is the day of the messages contained in each log file. 


The format of an error log message is as follows: 
<seq> <time> <level> <flags> <mid> <sid> <text> 
<seq> Error sequence number 

<time> ‘Time of message in hh:mm:ss 

<level> _ Priority level of message for tracing 


<flags> TT: the message was also sent to a tracing process 
F : indicates a fatal error 
N : send mail to the system administrator 


<mid> Module ID number of source 
<sid> Sub-id number of source 
<text> Formatted text of the error message 


Messages that appear in the error log are intended to report exceptional con- 
ditions that require the attention of the system administrator. Those mes- 
sages that indicate the total failure of a STREAMS driver or module should 
have the F flag set. Those messages requiring the immediate attention of the 
administrator will have the N flag set, which causes the error logger to send 
the message to the system administrator via mail(1). The priority level 
usually has no meaning in the error log but will have meaning if the message 
is also sent to a tracer process. 


Once initiated, strerr will continue to execute until terminated by the user. 
Commonly, strerr would be executed asynchronously. 


WARNINGS 


FILES 


Only one strerr process at a time is permitted to open the STREAMS log 
driver. : 


If a module or driver is generating a large number of error messages, running 
the error logger will cause a degradation in STREAMS performance. If a large 
burst of messages are generated in a short time, the log driver may not be able 
to deliver some of the messages. This situation is indicated by gaps in the 
sequence numbering of the messages in the log files. 


/usr/adm/streams/error.mm-dd 


SEE ALSO 
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NAME 


stty — set the options for a terminal 


SYNOPSIS 


stty [-a ][-¢ ] [ options ] 


DESCRIPTION 


stty sets certain terminal I/O options for the device that is the current stan- 
dardinput. Without arguments, it reports the settings of certain options. 


In this report, if a character is preceded by a caret (*), the value of that option 
is the corresponding Ctrl character (for example, “h is Ctrl-H; in this case, 
recall that Ctrl-H is the same as the Backspace key.) The sequence ** means 
that an option has a null value. 


-a Reports all of the option settings. 


-£ Reports current settings in a form that can be used as an argument to 
another stty command. 


Options in the last group are implemented using options in the previous 
groups. Note that many combinations of options make no sense, but no sanity 
checking is performed. The options are selected from the following: 


Control Modes: 


parenb(-parenb) Enable (disable) parity generation and detection. 
parodd (-parodd) Select odd (even) parity. 

cs5 cs6 cs7 cs8 Select character size (see termio(7)). 

0 Hang up phone line immediately. 

110300 600 1200 18002400 4800 9600 1920038400 


Set terminal baud rate to the number given, if possible. 
(All speeds are not supported by all hardware inter- 


faces.) 

hupel (-hupcl) Hang up (do not hang up) Dataphone Connection on last 
close. 

hup (-hup) Same as hupcl (-hupcl). 


estopb (-cstopb) —_ Use two (one) stop bits per character. 

cread (-cread) Enable (disable) the receiver. 

clocal (-clocal) Assume a line without (with) modem control. 

loblk (-loblk) Block (do not block) output from a non-current layer. 


Input Modes: 


ignbrk (-ignbrk) _Ignore (do not ignore) break on input. 

brkint (-brkint) Signal (do not signal) INTR on break. 

ignpar (-ignpar) _Ignore (do not ignore) parity errors. 

parmrk (-parmrk) Mark (do not mark) parity errors (see termio(7)). 
inpek (-inpck) Enable (disable) input parity checking. 

istrip (—istrip) Strip (do not strip) input characters to seven bits. 
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inler (~inler) 
igner (-igner) 
iernl (-icrn]l) 


iucle (-iucle) 


ixon (-ixon) 


ixany (-ixany) 
ixoff (-ixoff) 


Output Modes: 
opost (-opost) 


olcuc (-olcuc) 


onlcr (-onler) 
ocrn] (-ocrn]) 
onocr (-onocr) 
onlret (-onlret) 


ofill (-ofil) 
ofdel (-ofdel) 
cr0 crl cr2 cr3 
nlo nll 
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Map (do not map) NL to CR on input. 
Ignore (do not ignore) CR on input. 
Map (do not map) CR to NL on input. 


Map (do not map) uppercase alphabetics to lowercase on 
input. 


Enable (disable) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by sending 
an ASCII DC1. 


Allow any character (only DC1) to restart output. 


Request that the system send (not send) START/STOP 
characters when the input queue is nearly empty/full. 


Post-process output (do not post-process output; ignore 
all other output modes). 


Map (do not map) lowercase alphabetics to uppercase on 
output. 


Map (do not map) NL to CR-NL on output. 
Map (do not map) CR to NL on output. 
Do not (do) output CRs at column zero. 


On the terminal NL performs (does not perform) the CR 
function. 


Use fill characters (use timing) for delays. 

Fill characters are DELs (NULs). 

Select style of delay for carriage returns (see termio(7)). 
Select style of delay for line-feeds (see termio(7)). 


tab0 tabl tab2 tab3 Select style of delay for horizontal tabs (see termio(7)). 


bs0 bs1 

ff0 ff1 

vt0 vt1 
Local Modes: 

isig (-isig) 


icanon (-icanon) 


xcase (-xcase) 
echo (-echo) 


echoe (-echoe) 


Select style of delay for backspaces (see termio(7)). 
Select style of delay for form-feeds (see termio(7)). 
Select style of delay for vertical tabs (see termio(7)). 


Enable (disable) the checking of characters against the 
special control characters INTR, QUIT, and SWTCH. 


Enable (disable) canonical input (ERASE and KILL pro- 
cessing). . 

Canonical (unprocessed) upper/lowercase presentation. 
Echo back (do not echo back) every character typed. 
Echo (do not echo) ERASE character as a backspace- 
space-backspace string. Note: this mode will erase the 
ERASEed character on many CRT terminals. However, it 


does not keep track of column position and, as a result, 
may be confusing on escaped characters, tabs, and 
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backspaces. 
o . echok (-echok) Echo (do not echo) NL after KILL character. 
Ifke (-lfke) The same as echok (-echok); obsolete. 
echonl(-echonl) —_ Echo (do not echo) NL. 
noflsh (-noflsh) Disable (enable) flush after INTR, QUIT, or SWTCH. 


stwrap (-stwrap) Disable (enable) truncation of lines longer than 79 char- 
acters on a synchronous line. 


stflush (-stflush) Enable (disable) flush on a synchronous line after every 


write(2). 

stappl (-stappl) Use application mode (use line mode) on a synchronous 
line. 

tostop Sends signal SIGTTOU to the process group of a process 


that tries to write to its controlling terminal if it is not 
in the foreground process group for that terminal. 


iexten Enables eol2, xcase, ixany, iuclc, and olcuc. 


Control Assignments: : 
control-characterc Set control-character toc, where control-character is 

erase, kill, intr, quit, swtch, eof, eo], ctab, min, 
susp, or time (ctab is used with -stapp]; min and 
time are used with -icanon; see termio(7)). Ifc is pre- 
ceded by an (escaped from the shell) caret (*), then the 
value used is the corresponding Ctrl character (e.g., “dis 
a Ctrl-D); *? is interpreted as DEL and ~ is interpreted 
as undefined. 


line: Set line discipline toi (0 <i < 127). 
start ixoff and ixon start character. 
stop ixoff and ixon stop character. 


Screen Size Assignments: 
screen-dimensioni Set screen-dimension toi, where screen-dimension is 
rows, cols, xpixels, or ypixels. 


rows Number of lines on screen. 

cols Number of characters per line. 
xpixels Dots of resolution per horizontal line. 
ypixels Dots of resolution per vertical line. 


Combination Modes: 
evenp or parity Enable parenb and cs7. 


oddp Enable parenb, cs7, and parodd. 


-parity, -evenp, or -oddp 
Disable parenb, and set cs8. 


raw (-raw or cooked) 
Enable (disable) raw input and output (no Erase, Kill, 
INTR, QUIT, SWTCH, EOT, or output post processing). 
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nl (-nl) Unset (set) iernl, onler. In addition —nl unsets inler, 
igncr, ocrnl, and onlret. oS 
lease (-Icase) Set (unset) xcase, iucle, and olcuc. = 


LCASE (-LCASE) Same as Icase (-Icase). 
tabs (-tabs or tab3) Preserve (expand to spaces) tabs when printing. 


ek Reset Erase and Kill characters back to normal # and @. 
sane Resets all modes to some reasonable values. 
term Set all modes suitable for the terminal type term, where 


term is one of tty33, tty37, vt05, tn300, ti700, or tek. 


SEE ALSO 
tabs(1), ioct](2), termio(7) 
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NAME 
eo su — become superuser or another user 
SYNOPSIS 
su [-][ name [ arg... ]] 
DESCRIPTION 


su allows one to become another user without logging off. The default user 
name is root (i.e., superuser). 


To use su, the appropriate password must be supplied (unless one is already 
root). If the password is correct, su will execute a new shell with the real and 
effective user ID set to that of the specified user. The new shell will be the 
optional program named in the shell field of the specified user’s password file 
entry (see passwd(4)), or /bin/sh if none is specified (see sh(1)). To restore 
normal user ID privileges, type an EOF (Ctrl-D) to the new shell. 


Any additional arguments given on the command line are passed to the pro- 
gram invoked as the shell. When using programs like sh(1), an arg of the 
form -c string executes string via the shell and an arg of -r will give the user 
a restricted shell. 


The following statements are true only if the optional program named in the 
shell field of the specified user’s password file entry is like sh(1). If the first 
argument to su is a-, the environment will be changed to what would be 
expected if the user actually logged in as the specified user. This is done by 
invoking the program used as the shell with an argO value whose first charac- 
ter is -, thus causing first the system’s profile (/etc/ profile) and then the speci- 

© fied user’s profile (.profile in the new HOME directory) to be executed. Other- 
wise, the environment is passed along with the possible exception of $PATH, 
which is set to /bin:/etc:/usr/bin for root. Note that if the optional program 
used as the shell is /bin/sh, the user’s .profile can check arg0 for -sh or -su to 
determine if it was invoked by login(1) or su(1), respectively. If the user’s 
program is other than /bin/sh, then .profile is invoked with an argO of 
-program by both login(1) and su(1). 


All attempts to become another user using su are logged in the log file 
/usr/adm/sulog. 


EXAMPLES 
To become user bin while retaining your previously exported environment, 
execute this command: 


su bin 


To become user bin, but change the environment to what would be expected if 
bin had originally logged in, execute this command: 


su - bin 


To execute command with the temporary environment and permissions of 
user bin, type this command: 


gu — bin -c "command args" 


FILES 
@ /ete/passwd System password file 
/ete/profile System profile 
$HOME/ profile User profile 
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/usr/adm/sulog Log file 


SEE ALSO 
env(1), login(1), sh(1), passwd(4), profile(4), environ(5) 
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NAME 
sum — print checksum and block count of a file 


SYNOPSIS 
sum [ -r ] file 


DESCRIPTION 
sum calculates and prints a 16-bit checksum for the named file, and also 
prints the number of blocks in the file. It is typically used to look for bad spots 
or to validate a file communicated over a transmission line. The option -r 
causes an alternate algorithm to be used in computing the checksum. The 
block count will be reported in 512 byte blocks. 


SEE ALSO 
we(1) 
DIAGNOSTICS 


“Read error” is indistinguishable from end of file on most devices; check the 
block count. 
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NAME 
@ swap — swap administrative interface 
SYNOPSIS 


/etc/swap -a swapdev swaplen 
/etc/swap -1 


DESCRIPTION ‘ 
swap provides a method of adding, deleting, and monitoring the system swap 
areas used by the memory manager. The following options are recognized: 


-a Add the specified swap area. swapdeu is the name of the block special 
device, (e.g. /dev/dsk/zd1s1). swaplen is the length of the swap area in 
512-byte blocks. If the swaplen is specified as 0, the entire device will be 
used. If swaplen is non-zero, the minimum of the specified value and the 
actual size of the partition will be used. The starting block number is 
always 0 (zero). This option can be used only by the superuser. Swap 
areas are normally added by the system start-up routines in /ete/rc2.d 
when going into multiuser mode. Once a device has been allocated for 
swapping, it cannot be removed until reboot. 


-1 List the status of all the swap areas. The output has four columns: 


DEV The swapdev special file for the swap area if one can be found in 
the /dev/dsk or /dev directories, and its major/minor device 
number in decimal. 


LOW The swaplow value for the area in 512-byte blocks. 
* LEN The swaplen value for the area in 512-byte blocks. 


FREE The number of free 512-byte blocks in the area. If the swap area 
is being deleted, this column will be marked INDEL. 
SEE ALSO 
re(4), re2(1M) 
WARNINGS 


No check is done to see if a swap area being added overlaps with an existing 
swap area or filesystem. 
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NAME 


sweepon, sweepoff — enable/disable patrol seeks on DCC disks 


SYNOPSIS 


/etc/sweepon [-d] {-al drivename} 
/etc/sweepoff [-d] {-al drivename} 


DESCRIPTION 


FILES 


sweepon enables patrol seeks on one or multiple drives, while sweepoff dis- 
ables them. sweepon and sweepoff are links to the same program. The 
sweepon utility was created because DCC drive manufacturers recommend 
that disk heads be moved at regular intervals to increase drive longevity. 
Therefore, sweepon should always be invoked at system boot time. The -a 
option causes patrol seeks to be enabled/disabled on all configured DCC drives. 
Alternatively, a drivename can be specified which will cause patrol seeks to be 
enabled or disabled only on the indicated drive. drivename may be a simple 
disk name such as 2d0 or zd4, without any path prefix, or it may be a full path- 
name. If the first form is used, the appropriate path to the special device is 
generated automatically. 


If the -d option is specified, debug output is produced on stdout. 


When the -a option is used with sweepon, it is possible to cause devices to be 
skipped (so that patrol seeks are not enabled) by placing the simple device 
name of the drive in the file /etc/sweepon.ignore. The format of the 
sweepon.ignore file is one disk name per line. The name should start in the 
first column. Comment lines may be specified with a pound sign (#) in the first 
column. Blank lines are ignored. For example, if you wish to enable patrol 
seeks on all DCC drives except zd2, you would add zd2 to the sweepon.ignore 
file on its own line, and that device will be skipped when sweepon executes. 
This file is only looked at when the -< option is used, and only for sweepon. It 
is recommended that patrol seeks remain enabled on all DCC drives. 


/ete/sweepon.ignore 


DIAGNOSTICS 
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NAME 
sync — update the superblock 

SYNOPSIS 
sync 

DESCRIPTION 
sync executes the sync system primitive. If the system is to be stopped, 
sync must be called to insure filesystem integrity. It will flush all previously 
unwritten system buffers out to disk, thus assuring that all file modifications 
up to that point will be saved. See syne(2) for details. 


SEE ALSO 
sync(2) 
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NAME ; 
sysadm — menu interface to do system administration 


SYNOPSIS 
sysadm [ subcommand ] 


DESCRIPTION 
This command, when invoked without an argument, presents a menu of sys- 
tem administration subcommands, from which the user selects. If the optional 
argument is presented, the named subcommand is run or the named submenu 
is presented. 
The sysadm command can be given a password. See admpasswd in the 
Subcommands section. 
Subcommands 
The following menus of subcommands are available. (The number of bullets 
(* )in front of each item indicates the level of the menu or subcommand.) 
¢ diskmgmt 
disk management menu 


The subcommands on this menu allow you to check, mount, and 
unmount filesystems. 


° ¢ checkfsys ‘ 
check a filesystem for errors 


This procedure checks a filesystem for errors. If there are errors, this 
procedure attempts to repair them. 


¢ * harddisk 
hard disk management menu 


The subcommand on this menu allows you to view the partitions on a 
disk. 
° © © display 
display disk partitioning 
This procedure displays current disk partitioning information. 


¢ © mountfsys 
mount a filesystem 


This procedure mounts a filesystem, making it available to users. The 
filesystem must be unmounted with the umountfsys command. 


* * umountfsys 
unmount a filesystem 


This procedure unmounts a filesystem. umountfsys can be used only 
to unmount filesystems mounted with the mountfsys command. 


° filemgmt 
file management menu 
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Subcommands are also provided to determine which files might be 


The subcommands on this menu allow you to back up and restore files. 
best kept on disk based on age or size. @ 


° ¢ backup 
backup files from disk to tape 


This procedure saves copies of files from filesystems to tape. There are 
two kinds of backups: 


COMPLETE - copies all files (useful in case of serious filesystem dam- 
age) 


INCREMENTAL - copies files changed since the last backup 


The normal usage is to do a complete backup of each filesystem and 
then periodically do incremental backups. Two cycles are recom- 
mended (one set of complete backups and several incrementals to each 
cycle). Files backed up with backup are restored using restore. 


¢ © bupsched 
backup reminder scheduling menu 


Backup scheduling is used to schedule backup reminder messages and 
backup reminder checks. Backup reminder messages are sent to the 
console to remind the administrator to back up particular filesystems 
when the machine is shut down or a reminder check has been run dur- 
ing the specified time period. 


Backup reminder checks specify particular times at which the system 
will check to see if any backup reminder messages have been sched- 
uled. 


¢ ¢ ¢ schedcheck 
schedule backup reminder checks 


Backup reminder checks are run at specific times to see if any remind- 
ers are scheduled. The user specifies the times at which the check is 
to be run. Checks are run for the reminder messages scheduled by 
schedmsg. 


¢ ¢ © schedmsg 
schedule backup reminder message 


Backup reminder messages are sent to the console if the machine is 
shut down or a reminder check has been scheduled. The user specifies 
the both times at which it is appropriate to send a message and the 
filesystems to be included in the message. 


¢ ¢ diskuse 
display how much disk space is being used 


This procedure displays the percentage of disk space currently occu- 
pied by files. The list is organized by filesystem names. 
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* ¢ fileage 
list files older than a particular date 


fileage prints the names of all files older than the specified date. If no 
date is entered, all files older than 90 days will be listed. If no direc- 
tory is specified, the /usr/admin directory will be used. 


° ¢ filesize 
list the largest files in a particular directory 


filesize prints the names of the largest files in a specific directory. If 
no directory is specified, the /usr/admin directory will be used. If you 
don’t specify the number of files to print, 10 files will be listed. 


* ¢ restore 
restore files from backup and store media to disk 


restore copies files from tapes made by backup and store back onto 
disk. You can restore individual files, directories of files, or the entire 
contents of a tape. You can restore from both "incremental" and "com- 
plete" media. You can also list the names of files stored on the tape. 


* ¢ store 
store files and directories of files onto tape 


store copies files from disk to tape and allows you to optionally verify 
that they worked and to optionally remove them when done. Typi- 
cally, these would be files that you want to archive or restrict access 
to. You can store single files and directories of files. Use the restore 
command to place stored files back on disk and to list the files stored. 


* machinemgmt 
machine management menu 


Machine management functions are tools used to operate the machine 
(such as rebooting or going to the firmware monitor). 


¢ ¢ firmware 
stop all running programs then enter firmware mode 


This procedure stops all running programs, closes any open files, 
writes out information to disk (such as directory information), then 
enters the firmware mode. (Machine diagnostics and other special 
functions that are not available on the operating system can be run in 
firmware mode.) 


¢ ¢ reboot 
stop all running programs then reboot the machine 


reboot stops all running programs, closes any open files, writes out 
information to disk (such as directory information), and then reboots 
the machine. This procedure can be used to get out of some types of 
system trouble, such as when a process cannot be killed. 
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¢ ¢ whoson 
print list of users currently logged onto the system 


whoson prints the login ID, terminal device number, and sign-on time 
of all users who are currently using the computer. 


* packagemgmt 
package management 


These submenus and subcommands manage various software pack- 
ages such as Ip and uucp. 


* softwaremgmt 
software management menu 


These subcommands permit the user to install, list, or remove soft- 
ware. The "remove" capability is dependent on the software package. 
See the instructions delivered with each package. 

¢ ¢ installpkg 
install new software package onto disk 


install copies files onto disk and performs additional work if necessary 
so that the software can be run. 


¢ ¢ listpkg 
list packages already installed 


This subcommand shows you a list of currently installed software 
packages. 


° ¢ removepkg 
remove previously installed package from disk 


This subcommand displays a list of currently installed software pack- 
ages. The actions necessary to remove the software packages you 
specify will then be performed. 


¢ syssetup 
system setup menu 


System setup routines allow the user to tell the computer what its 
environment looks like: what the date, time, and time zone are, what 
administration and system capabilities are to be under password con- 
trol, what the machine’s name is, and so on. The first-time setup 
sequence is also here. 


¢ ¢ admpasswd 
assign or change administrative passwords 


admpasswd lets you set or make changes to passwords for adminis- 
trative commands and logins such as setup and sysadm. 


° ¢ datetime 
set the date, time, time zone, and daylight savings time 
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datetime tells the computer the date, time, time zone, and whether 
you observe Daylight Savings Time (DST). It is normally run once 
when the machine is first set up. If you observe DST, the computer 
will automatically start to observe it in the spring and return to Stan- 
dard Time in the fall. The machine has to be turned off and turned 
back on again to guarantee that ALL times will be reported correctly. 
Most are correct the next time the user logs in. 


* ¢ nodename 


set the node name of this machine 


This allows you to change the node name of this machine. The node 
name is used by various communications networks to identify this 
machine. 


¢ ¢ setup 


set up your machine the very first time . 


setup allows you to define the first login, to set the passwords on the 
user-definable administration logins, and to set the time zone for your 
location. 


° © syspasswd 


assign system passwords 


syspasswd lets you set system passwords normally reserved for the 
very knowledgeable user. For this reason, this procedure can assign 
those passwords, but cannot change or clear them. Once set, they can 
only be changed by the specific login or the root login. 


* ttymgmt 


terminal management 


This procedure allows you to manage the computer’s terminal func- 
tions. 


¢ ¢ lineset 


show tty line settings and hunt sequences 


The tty line settings are often hunt sequences where, if the first line 
setting does not work, the line "hunts" to the next line setting until it 
reaches one that does work. This subcommand shows the various 
sequences with only the names of the line settings they contain. It 
also shows each line setting in detail. 


° ¢ mklineset 
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create new tyy line settings and hunt sequences 


This subcommand helps you to create entries for tty line settings. You 
might want to add line settings that are not in the current set or to 
create hunt sequences with only specific line settings in them. The 
created hunt sequences are circular; stepping past the last setting 
puts you on the first. 
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* © modtty 
show and optionally modify characteristics of tty lines 


This subcommand reports and allows you to change the characteristics 
of tty lines (also called “ports"). 


* usermgmt 
user management menu 


These subcommands allow you to add, modify and delete the list of 
users that have access to your machine. You can also place them in 
separate groups so that they can share access to files within the group 
but protect themselves from other groups. 


¢ ¢ addgroup 
add a group to the system 


addgroup adds a new group name or ID to the computer. Group 
names and IDs are used to identify groups of users who desire common 
access to a set of files and directories. 


© ¢ adduser 
add a user to the system 


adduser installs a new login ID on the machine. You are asked a 
series of questions about the user and then the new entry is made. 
You can enter more than one user at a time. Once this procedure is 
finished, the new login ID is available. 


¢ ¢ delgroup 
delete a group from the system 


delgroup allows you to remove groups from the computer. The 
deleted group is no longer identified by name. However, files can still 
be identified with the group ID number. 


¢ ¢ deluser 
delete a user from the system 


deluser allows you to remove users from the computer. The deleted 
user’s files are removed from disk and their logins are removed from 
the /etc/ passwd file. 

¢ ¢ Isgroup 
list groups in the system 


Isgroup lists al] groups that have been entered into the computer. 
This list is updated automatically by addgroup and delgroup. 

¢ ¢ lsuser 
list users in the system 


Isuser lists al] users that have been entered into the computer. This 
list is updated automatically by adduser and deluser. 
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° ¢ modadduser 
modify defaults used by adduser 


modadduser allows you to change some of the defaults used when 
adduser creates a new login. Changing the defaults does not affect 
any existing logins, only logins made from this point on. 

* © modgroup 
make changes to a group on the system 


modgroup allows you to change the name of a group. 


* ¢ moduser 
menu of commands to modify a user’s login 


This menu contains commands that modify the various aspects of a 
user’s login. 

© © ¢ chgloginid 
change a user’s login ID 


This procedure allows you to change a user’s login ID. Administrative 
and system logins cannot be changed. 


¢ © © chgpasswd 
change a user’s passwd 


This procedure allows removal or change of a user’s password. Admin- 
istrative and system login passwords cannot be changed. To change 
administrative and system login passwords, see the system setup 
menu: sysadm syssetup. 


¢ © © chgshell 
change a user’s login shell 


This procedure allows you to change the command run when a user 
logs in. The login shell of the administrative and system logins cannot 
be changed by this procedure. 


EXAMPLES 
sysadm adduser 
FILES 
The files that support sysadm are found in /usr/admin. 


The menu starts in the directory /usr/admin/menu. 
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NAME 
tabs — set tabs on a terminal 

SYNOPSIS 
tabs [tabspec] [-Ttype] [+mn] 

DESCRIPTION 
tabs sets the tab stops on the user’s terminal according to the tab specifica- 
tion tabspec, after clearing any previous settings. The user’s terminal must 
have hardware tabs that can be set remotely. 


tabspec Four types of tab specification are accepted for tabspec: 
canned (-code) 
repetitive (-n) 
arbitrary (n1,n2,...) 
file (--file) 
If no tabspec is given, the default value is -8 (i.e., “standard” tabs). 
The lowest column number is 1. Note that for tabs, column 1 always 
refers to the leftmost column on a terminal, even one whose column 
markers begin at 0, such as the DASI 300, DASI 300s, and DASI 450. 
~-code Use one of the codes listed below to select a canned set of tabs. The 
legal codes and their meanings are as follows: 
-a  ——-:1,10,16,36,72 
Assembler, IBM S/370, first format 
-a2 = 1,10,16,40,72 
Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 
COBOL, normal format 
-c2 1,6,10,14,49 
COBOL compact format (columns 1-6 omitted). Using this code, 
the first typed character corresponds to card column 7, one 
space gets you to column 8, and a tab reaches column 12. Files 


using this tab setup should include a format specification as 
follows (see fspec(4)): 


<:t-c2 m6 s66 d:> 


-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 
COBOL compact format (columns 1-6 omitted), with more tabs 
than -c2. This is the recommended format for COBOL. The 
appropriate format specification is as follows (see fspec(4)): 


<:t-c3 m6 s66 d:> 
-f 1,7,11,15,19,23 


FORTRAN 
-p _1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 
PL/I 
6 = 1,10,55 
SNOBOL 
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-u =: 1,12,20,44 
UNIVAC 1100 Assembler 
—n A repetitive specification requests tabs at columns 1+n, 1+2*n, ete. 
Of particular importance is the value 8; this represents the “stan- 
dard” tab setting and is the most likely tab setting to be found at a 
terminal. Another special case is the value 0, implying no tabs at 
all. 


n1,n2,... The arbitrary format permits the user to type any chosen set of num- 
bers, separated by commas, in ascending order. Up to 40 numbers 
are allowed. If any number (except the first one) is preceded by a 
plus sign, it is taken as an increment to be added to the previous 
value. Thus, the formats 1,10,20,30, and 1,10+10,+10 are considered 
identical. 


--file If the name of a file is given, tabs reads the first line of the file, 
searching for a format specification (see fspec(4)). If it finds one 
there, it sets the tab stops according to it, otherwise it sets them as - 
-8. This type of specification may be used to make sure that a 
tabbed file is printed with correct tab settings and would be used 
with the pr(1) command: 


tabs —- file; pr file 


Any of the following also may be used. If a given flag occurs more than once, 
the last value given takes effect: 


-Tyype _ tabs usually needs to know the type of terminal in order to set tabs 
and always needs to know the type to set margins. type is aname 
listed in term(5). If no -T flag is supplied, tabs uses the value of 
the environment variable TERM. If TERM is not defined in the envi- 
ronment (see environ(5)), tabs tries a sequence that will work for 
many terminals. 


+mn The margin argument may be used for some terminals. It causes all 
tabs to be moved over n columns by making column n+1 the left 
margin. If +m is given without a value of n, the value assumed is 
10. For a TermiNet, the first value in the tab list should be 1, or the 
margin will move even further to the right. The normal (leftmost) 
margin on most terminals is obtained by +m0. The margin for most 
terminals is reset only when the +m flag is given explicitly. 


Tab and margin setting is performed via the standard output. 


EXAMPLES 
tabs -a Example of using -code (canned specification) to set tabs to the 
settings required by the IBM assembler: columns 1, 10, 16, 36, 
72. 
tabs -8 Example of using -n (repetitive specification), where n is 8, 


causes tabs to be set every eighth position: 1+(1*8), 1+(2*8), ... 
which evaluate to columns 9, 17, ... 


tabs 1,8,36 Example of using n1,n2,... (arbitrary specification) to set tabs at 
columns 1, 8, and 36. 


2 12/89 


DYNIX/ptx TABS(1) 


tabs --$HOME/fspec.list/att4425 
Example of using —-file (file specification) to indicate that tabs 
should be set according to the first line of 
$HOME/fspec.list /att4425 (see fspec(4)). 


DIAGNOSTICS 
illegal tabs Arbitrary tabs are ordered incorrectly. 
illegalincrement A zero or missing increment is found in an arbitrary spec- 
ification. 
unknown tab code Acanned code cannot be found. 
can’t open --file option was used and file can’t be opened. 


file indirection ~-file option was used and the specification in that file 
points to yet another file. Indirection of this form is not 
permitted. 


SEE ALSO 
newform(1), pr(1), tput(1), fapec(4), terminfo(4), environ(5), term(5) 

NOTE 
There is no consistency among different terminals regarding ways of clearing 
tabs and setting the left margin. 
tabs clears only 20 tabs (on terminals requiring a long sequence), but is wil- 
ling to set 64. 

WARNINGS 
The tabspec used with the tabs command is different from the one used with 
the newform(1) command. For example, tabs -8 sets every eighth position; 
whereas newform -i-8 indicates that tabs are set every eighth position. 
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NAME 


tail — deliver the last part of a file 


SYNOPSIS 


tail [ +{number][be[f] ] ] [ file ] 


DESCRIPTION 


tail copies the named file to the standard output beginning at a designated 
place. If no file is named, the standard input is used. 


Copying begins at distance +number from the beginning of the input or -num- 
ber from the end (if number is null, the value 10 is assumed). Number is 
counted in units of lines, blocks, or characters, according to the appended 
option I, b, or c. When no units are specified, counting is by lines. 


With the -f (“follow”) option, if the input file is not a pipe, the program will not 
terminate after the line of the input file has been copied, but will enter an 
endless loop, wherein it sleeps for a second and then attempts to read and copy 
further records from the input file. Thus, it may be used to monitor the 

growth of a file that is being written by some other process. For example, the 
following command prints the last 10 lines of the file fred, followed by any 
lines that are appended to fred between the time tail is initiated and killed. 


tail -f fred 


As another example, the next command prints the last 15 characters of the file 
fred, followed by any lines that are appended to fred between the time tail is 
initiated and killed. 


tail -15cf fred 


SEE ALSO 


dd(1M) 


WARNINGS 


BUGS 
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The tail command will tail only the last 4096 bytes of a file regardless of its 
line count. 


Tails relative to the end of the file are stored in a buffer, and thus are limited 


in length. Various kinds of anomalous behavior may happen with character 
special files. 
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NAME 
tar — tape file archiver 


SYNOPSIS 
/bin/tar -c[vwfbh[#s]] device block files ... 
/bin/tar -r[vwh[#s]] device block [files ...] 
/bin/tar -t[vfl#s]] device 
/bin/tar -ulvwhb[#s]] device block [files ...] 
/bin/tar -x[lmovwf{[#s]] device [files ...] 


DESCRIPTION 
tar saves and restores files on magnetic tape. Its actions are controlled by the 
key argument. The key is a string of characters containing one function letter 
(e, r, t, u, or x) and possibly followed by one or more function modifiers (v, w, 
f, b, and #). Other arguments to the command are files (or directory names) 
specifying which files are to be dumped or restored. In all cases, appearance of 
a directory name refers to the files and (recursively) subdirectories of that 
directory. 
The tape is written using the “extended tar format” defined by the POSIX 
1003.1 standard. Tapes can consist of multiple volumes; for more information, 
see the discussion following the list of command arguments. This tar reads 
tapes written by BSD and ATT tar programs as well as other tapes conform- 
ing to the POSIX format. Tapes written in the extended tar format can be 
read by BSD tar as long as only directories and regular files are placed on the 
tape. For compatibility with older tar progams not adhering to the POSIX 
specification, the program otar is supplied. This program writes tapes in the 
format expected by ATT tar programs. 
POSIX compliance requires that the user’s umask value shall modify file cre- 
ation modes unless the root user is executing the program. The AT&T seman- 
tics were such that tar would set the umask value to 0 before creating files. 
This is now done only when the root user executes the program. Non-root 
users wishing to have files extracted with the same modes as appear on tape 
must set the umask value to 0 before executing the tar program. 


The function portion of the key is specified by one of the following letters: 


r Replace. The named files are written on the end of the tape. The c 
function implies this function. 
x Extract. The named files are extracted from the tape. If a named file 


matches a directory whose contents had been written onto the tape, 
this directory is (recursively) extracted. Use the file or directory’s rel- 
ative path when appropriate, or tar will not find a match. The 
owner, modification time, and mode are restored (if possible). If no 
files argument is given, the entire content of the tape is extracted. 
Note that if several files with the same name are on the tape, the last 
one overwrites all earlier ones. 


t Table. The names and other information for the specified files are 
listed each time that they occur on the tape. The listing is similar to 
the format produced by the Is -1 command. If no files argument is 
given, all names on the tape are listed. 
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there or have been modified since last written on that tape. This key 


u Update. The named files are added to the tape if they are not already 
implies the r key. @ 


c Create a new tape; writing begins at the beginning of the tape, 
instead of after the last file. This key implies the r key. 


The characters below may be used in addition to the letter that selects the 
desired function. Use them in the order shown in the synopsis. 


ts This modifier determines the drive on which the tape is mounted 
(replace # with the drive number) and the speed of the drive (replace 
s with 1, m, or h for low, medium or high). The modifier tells tar to 
use a drive other than the default drive (or the drive specified with 
the -f option). For example, with the 5h modifier, tar would use 
/dev/rmt/xtOh or /dev/rmt/ts0h instead of the default drives 
/dev/rmt/xt0 or /dev/rmt/ts0, respectively. However, 
if -f /dev/rmt/tm0 appeared on the command line, tar would use 
/dev/rmt/tm0. 


v Verbose. Normally, tar does its work silently. The v (verbose) option 
causes it to type the name of each file it treats, preceded by the func- 
tion letter. With the t function, v gives more information about the 
tape entries than just the name. 


w What. This causes tar to print the action to be taken, followed by the 
name of the file, and then wait for the user’s confirmation. If a word 
beginning with y is given, the action is performed. Any other input 
means “no”. This is not valid with the t key. 

f File. This causes tar to use the device argument as the name of the 
archive instead of /dev/rmt/xtO or /dev/rmt/ts0. If the name of the 
file is -, tar writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as the head or 
tail of a pipeline. tar can also be used to move hierarchies with the 


command: 
ed fromdir; tar cf -. | (cd todir; tar xf -) 
b Blocking Factor. This causes tar to use the block argument as the 


blocking factor for tape records. The default is 1, the maximum is 20. 
This function should not be supplied when operating on regular 
archives or block special devices. It is mandatory however, when 
reading archives on raw magnetic tape archives (see f above). The 
block size is determined automatically when reading tapes created on 
block special devices (key letters x and t). 


1 Link. This tells tar to complain if it cannot resolve all of the links to 
the files being dumped. If 1 is not specified, no error messages print. 

m Modify. This tells tar not to restore the modification times. The 
modification time of the file will be the time of extraction. 

° Ownership. This causes extracted files to take on the user and group 


identifier of the user running the program, rather than those on tape. 
This is only valid with the x key. é 
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FILES 


h Force tar to follow symbolic links as if they were normal files or 
directories. Normally, tar does not follow symbolic links. 


In compliance with the POSIX specification, the tar program provides support 
for multiple volumes. Ifthe end of tape is reached, tar prompts for a new 
device. Mount the next tape, then press Return at the prompt. The program 
will then open the device last used for I/O and continue reading or writing. 


If you want to abort the read or write, enter the letter q to terminate the tar 
program. If you were writing to the tape, the data up to the last file placed on 
the tape will be readable. The file being written when the end of tape was 
reached will be incomplete. 


When using multi-volume tapes with this program, it is guaranteed that the 
final block on the tape will contain an even multiple of 512 bytes. However, 
the block might be smaller than the block size used on the rest of the tape. 
This program will accept other POSIX-compliant 1/2-inch tar tapes as long as 
the final block on the tape is written in an integer multiple of 512 bytes. 


Cartridge tapes should not be considered interchangable with non-Sequent 
machines. For interchange with non-Sequent machines use 1/2 inch tapes. 
With the exception of the final file on the tape, a tar program that does not 
support multiple volumes should be able to read the first reel of a multi-vol- 
ume tar tape. The remainder of the tapes are not usable. For this reason, if 
you are creating tapes to be used on a machine that might not be POSIX-com- 
pliant, you should place all information on a single tape. 


/dev/Armt/* 


SEE ALSO 


ar(1), cpio(1), 1s(1) 


DIAGNOSTICS 


BUGS 


Complains about bad key characters and tape read/write errors. 
Complains if not enough memory is available to hold the link tables. 


There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be updated. 
The current magnetic tape driver cannot backspace raw magnetic tape. If the 
archive is on a disk file, the b option should not be used at all, because updat- 
ing an archive stored on disk can destroy it. 

otar limits filenames to 100 characters. The POSIX format used by tar 
extends this limit to 255 characters. However, to achieve this limit, a "/" in 
the pathname would have to occur at 156 characters from the start of the 
filename. Therefore, it is likely that less than the theoretical maximum 
filename length can be preserved. 

otar will not copy empty directories and special files. tar does write both of 
these to tape. 
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NAME 


tasktbl — create security table in shared memory 


SYNOPSIS 


tasktbl 


DESCRIPTION 


The Create Security Table (tasktbl) command is used to create an in-memory 
version of the security information in the global security table 
($TFADMFILE] etc /task). This command speeds access to critical information 
and allows the menu program to quickly and efficiently resolve security refer- 
ences as each menu is displayed. 


The ptx/ADMIN menu system uses the security table to verify if a user can 
access a menu option. tasktbl is usually called by the menu system (menu) 
when the system fails to access the security table. When tasktbl is called, the 
system displays a message on the screen to advise the user that it is regen- 
erating the security table. 


Several commands in the menu system (for example, Add a User Account) 
remove the in-memory copy of the security table to prevent use of invalid or 
out-of-date security information. The next user to display a menu and select a 
command will automatically call the tasktbl program and trigger the regen- 
eration of the security table. 


The system password and group files (/etc/passwd and /etc/group) as well as 
the disk based version of the security table ($TFADMFILE /etc/task) store the 
information used to create the in-memory version of the security table. If any 
of these three files are altered, use the Delete Security Table command 
(dltsectbl) to remove the in-memory copy of the table. The menu system will 
generate a new copy when it is required. 


If security information is static, you can add a call to the tasktbl program to 
the system startup routine. This call will generate the security table as part 
of the general system initialization. 


FILES 
$(TFADMFILE)/etc/task Global task table 
/etc/group System group file 
/etc/passwd System password file 
SEE ALSO 


NOTES 
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ditsectbl(1M), menu(1M), tfipe(1M) 


This command is usually called by the menu system. 
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NAME 

tee — pipe fitting 
SYNOPSIS 

tee [-i] [-a][ file]... 


DESCRIPTION 
tee transcribes the standard input to the standard output and makes copies in 
the files. The options for this command are as follows: 


-i Ignore interrupts. 
-a Cause the output to be appended to the files rather than overwriting 
them. 
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NAME 
& test — condition evaluation command 


SYNOPSIS 
Bourne and Korn Shell 
test 
expr 
[expr] 
C Shell 
/bin/test 
expr 

DESCRIPTION 

Bourne and Korn Shell 

test evaluates the expression expr and, if its value is true, sets a zero (true) 
exit status; otherwise, a non-zero (false) exit status is set. test also setsa 
non-zero exit status if there are no arguments. When permissions are tested, 
the effective user ID of the process is used. 


All operators, flags, and brackets (brackets used as shown in the second SYN- 
OPSIS line) must be separate arguments to the test command. Normally 
these items are separated by spaces. 


The following primitives are used to construct expr: 


-r file True if file exists and is readable. 
® -wfile True ifffile exists and is writable. 
-x file True if file exists and is executable. 
-f file True if file exists and is a regular file. 
—d file True if file exists and is a directory. 
-c file True if file exists and is a character special file. 
-b file True if file exists and is a block special file. 
-p file True if file exists and is a named pipe (fifo). 
-u file True if file exists and its set-user-ID bit is set. 
~g file True if file exists and its set-group-ID bit is set. 
—k file True if file exists and its sticky bit is set. 
-s file True if file exists and has a size greater than zero. 


-t[fildes] True ifthe open file whose file descriptor number is fildes (1 by 
default) is associated with a terminal device. 


-z81 True if the length of string s/ is zero. 

-nel True if the length of the string s1 is non-zero. 
sl =s2 True if strings s1 and s2 are identical. 

sl l=s2 True if strings s1 and s2 are not identical. 

sl True ifs1 is not the null string. 
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nl-eqn2 True ifthe integers n1 and n2 are algebraically equal. Any of 
the comparisons -ne, ~gt, ~ge, -It, and -le may be used in place 
of -eq. 

These primaries can be combined with the following operators: 


! Unary negation operator. 

-a Binary and operator. 

-o Binary or operator (—a has higher precedence than -o). 

( expr ) Parentheses for grouping. Parentheses are meaningful to the 


shell and, therefore, must be quoted. 


C Shell 
/bin/test evaluates the expression expr, and if its value is true then returns 
zero exit status; otherwise, a non zero exit status is returned. /bin/test 
returns a non zero exit if there are no arguments. 


The following primitives are used to construct expr. 

-rfile true if the file exists and is readable. 

-wfile true if the file exists and is writable. 

-ffile true if the file exists and is not a directory. 

-dfile true if the file exists and is a directory. 

-sfile _ true if the file exists and has a size greater than zero. 


-t [ fildes ] 
true if the open file whose file descriptor number is fildes (1 by 
default) is associated with a terminal device. 


-zsl true if the length of string s/ is zero. 

-nsl true if the length of the string s7 is nonzero. 
sl=s2_ true ifthe strings s1 and s2 are equal. 
sl!=s2 true ifthe strings s] and s2 are not equal. 


sl true if s/ is not the null string. This will only work if no other primi- 
tives are used in expr. 


nl -eq n2 
true if the integers n1 and n2 are algebraically equal. Any of the 
comparisons —ne, —gt, -ge, -It, or -le may be used in place of -eq. 


These primaries may be combined with the following operators: 
! unary negation operator 

-a binary and operator 

oO binary or operator 


(expr ) 

parentheses for grouping. 
-a has higher precedence than -o. Notice that all the operators and flags are 
separate arguments to test. Notice also that parentheses are meaningful to 
the Shell and must be escaped. 
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The left bracket ([ ) is a shell alias for the test command. This lets you create 
3 shell scripts using the following construct: 


if [ <conditional expr> ] ; then ... 


SEE ALSO 
esh(1), find(1), ksh(1), sh(1) 


WARNINGS 
If you test a file you own (the -r, -w, or -x tests), but the permission tested 
does not have the owner bit set, a non-zero (false) exit status will be returned 
even though the file may have the group or other bit set for that permission. 
The correct exit status will be set if you are superuser. 


The = and != operators have a higher precedence than the -r through —n oper- 
ators, and = and != always expect arguments. Therefore, = and != cannot be 
used with the -r through —n operators. 


If more than one argument follows the -r through —n operators, only the first 
argument is examined. The others are ignored, unless —a or —-o is the second 
argument. 
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NAME 
GS : tfipc — interprocess communication reporter 


SYNOPSIS 
tfipe [-r] [-s] [-d] 


DESCRIPTION 
The Interprocess Communication Reporter (tfipe) command identifies and dis- 
plays all interprocess communication items used by the ptx/ADMIN menu sys- 
tem. This includes message queues for sending messages, shared memory for 
the security table, and semaphores that control access to the shared memory 
segment. 


-r This instructs the Interprocess Communication Reporter to identify 
and remove all menu system related message queues, shared memory 
segments, and semaphores. The remove flag is optional. 


48 Silent mode instructs the reporter to omit the display of the ids and 
explanation of each ipc element. This is generally used in conjunction 
with the remove option to silently remove all ipc components. Selec- 
tion of silent mode is optional and relevant only when coupled with the 
remove option. 


-d Detail mode instructs the reporter to display the ids, explanation, and 
detailed information for each ipc element. Selection of detail mode is 
optional. 

SEE ALSO 
© menu(1M), menumsg(1M), tasktbl(1M) 
NOTES 


When you remove the message queues, any messages in the queue are also 
removed. 
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NAME 
@ tfmenush — assign menu system as user login shell 


SYNOPSIS 
tfimenush 


DESCRIPTION 
The tfmenush command lets you assign the menu system as a user’s login 
shell. When you use this command, the program /bin/sh reads commands 
from the system profile /etc/profile and from the .profile in the user’s home 
directory. The command then executes the menu system, menuprom, located 
in the $TFBIN directory. 


EXAMPLES 
A System Administrator installs the menu system in the /usr/tf directory. To 
ensure that a user enters the menu system when they logon, the System 
Administrator must enter the full pathname of the tfmenush program in the 
user’s entry in the /etc/ passwd file. 


The following example is a typical entry in the /etc/passwd for menu system 
user Bill: 


bill::101:100:Billy Boy:/u/bill:/usr/tf/bin/tfmenush 
To ensure that tfmenush knows where to find the menu system (menu), the 


System Administrator enters the following line in the menu system Environ- 
ment File /etc/tfenv: 


TFBIN=/usr/tf/bin 
@ If this environment variable is not set, the login process will fail and the user 
cannot log onto the system. 
The following steps occur during the login process: 


1. The login process spawns a Bourne shell that runs commands found in 
/etc/ profile and $HOME/.profile. 


The commands in /etc/ profile establish the value of the environment 
variable TFBIN. The environment variable TERM is generally set in the 
$HOME]|.profile file. To help avoid conflict with other software, the 
menu system can use the environment variable TFTERM to set the ter- 
minal type. TFTERM is set in the user’s $HOME/.profile. 


2. The login shell turns control over to tfmenush. 
3.  tfmenush resets the value of the SHELL environment variable to 
/bin/sh and executes the menu system, $TFBIN/menu. Note that 


unless the TFBIN environment variable is set in the /etc/ profile, 
tfmenush fails at this point and log the user off the system. 


Environment Variables (set in /etc/tfenv) 
TFBIN Contains the name of the directory where the menu system 
standard binaries are stored. 


TFADMBIN Contains the name of the directory where the System Adminis- 


trator’s binaries are stored. In many installations, TFBIN and 
TFADMBIN are set to the same value. 
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TFADMFILE Contains the name of the head directory where menu system 
subdirectories are stored. There are four important directories: 


etc Control information 

misc Error logs and dead messages 
edc Compiled forms (in most cases) 
menu Menu definitions (in most cases) 


FILES 
/etc/passwd System password file 
/etce/tfenv Establishes TFBIN environment variable 
$HOME/.profile Establishes TERM and/or TFTERM variables 
SEE ALSO 


login(1), menu(1M), passwd(4) 
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NAME 
tfnotify — send completion message 


SYNOPSIS 
tinotify [message] 


DESCRIPTION 
A program can use the The Send Completion Message (tfnotify) command to 
send a message to a user. If there is an active menu process at the user’s ter- 
minal, tfnotify places the message in the ptx/ADMIN menu system menu 
message queue. If there is not an active menu process at the terminal, the 
message is displayed on the standard error. 


This command is primarily used to send completion messages to a user from a 
shell command or from within a form template. 


message Text of the message sent to the message queue or displayed on the 
standard error. If message text is not entered on the command 
line, the standard input is read. Message text is required. 


Environment Variables 
TFUSER Contains the name of the user who will receive the message. Set 
by the menu process. 


TFITY Contains the name of the terminal that will receive the message. 


Set by the menu process. 
FILES 
/etc/passwd System password file 
$(TFADMFILE)/menumsg/* System message files 
${(TFADMFILE)/misc/dead.msg System dead message file 
SEE ALSO 


menu(1M), menumsg(1M) 


12/89 1 


DYNIX/ptx TIC(1M) 


NAME 


tic — terminfo compiler 


SYNOPSIS 


tic [-v[n]] [-<] file 


DESCRIPTION 


FILES 


tic translates a terminfo(4) file from the source format into the compiled for- 
mat. The results are placed in the directory /usr/lib/terminfo. The compiled 
format is necessary for use with the library routines described in curses(3X). 


-vn (Verbose) output to standard error trace information showing tic’s 
progress. The optional integer n is a number from 1 to 10, inclusive, 
indicating the desired level of detail of information. Ifn is omitted, 
the default level is 1. Ifn is specified and greater than 1, the level of 
detail is increased. 


-c Only check file for errors. Errors in use= links are not detected. 


file Contains one or more terminfo terminal descriptions in source for- 
mat (see terminfo(4)). Each description in the file describes the 
capabilities of a particular terminal. When a use=entry-name field is 
discovered in a terminal entry currently being compiled, tic reads in 
the binary from /usr/lib/terminfo to complete the entry. (Entries 
created from file will be used first. If the environment variable TER- 
MINFO is set, that directory is searched instead of /usr/lib/ter- 
minfo.) tic duplicates the capabilities in entry-name for the current 
entry, with the exception of those capabilities that explicitly are 
defined in the current entry. 


If the environment variable TERMINFO is set, the compiled results are placed 
there instead of /usr/lib/terminfo. 


/usr/lib/terminfo/?/* | Compiled terminal description database 


SEE ALSO 


curses(3X), term(4), terminfo(4) 


DIAGNOSTICS 
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Most diagnostic messages produced by tic during the compilation of the source 
file are preceded with the approximate line number and the name of the ter- 
minal currently being worked on. 


mkdir ... returned bad status 
The named directory could not be created. 
File does not start with terminal names in column one 
The first thing seen in the file, after comments, must be the list of ter- 
minal names. 
Token after a seek (2) not NAMES 
Somehow the file being compiled changed during the compilation. 
Not enough memory for use_list element 
or 


Out of memory ; ; 
Not enough free memory was available (malloc(3) failed). 
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Can’t open... 
The named file could not be created. 
Error in writing ... 
The named file could not be written to. 
Can't link... to 
Alink failed. 
Error in re-reading compiled file ... 
The compiled file could not be read back in. 
Premature EOF 
The current entry ended prematurely. 
Backspaced off beginning of line 
This error indicates something wrong happened within tic. 
Unknown Capability -"..." 
The named invalid capability was found within the file. 


non 


Wrong type used for capability "... 
For example, a string capability was given a numeric value. 


Unknown token type 
Tokens must be followed by ‘@’ to cancel, ‘, for booleans, ‘# for num- 
bers, or ‘=’ for strings. 

""s bad term name 
or 

Line ...: Illegal terminal name -"...” 

Terminal names must start with a letter or digit 
The given name was invalid. Names must not contain white space or 
slashes, and must begin with a letter or digit. 


": terminal name too long. 
An extremely long terminal name was found. 


": terminal name too short. 
Aone-letter name was found. 
«." filename too long, truncating to "..." 
The given name was truncated to 14 characters due to filename length 
limitations. 
.." defined in more than one entry. Entry being used is "...". 
An entry was found more than once. 
Terminal name "..." synonym for itself 
'  Aname was listed twice in the list of synonyms. 
At least one synonym should begin with a letter. 
At least one of the names of the terminal should a with a letter. 
Illegal character - "..." 
The given invalid character was found in the input file. 
Newline in middle of terminal name 
The trailing comma was probably left off i the list of names. 


Missing comma 
Acomma was missing. 
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Missing numeric value 
The number was missing after a numeric capability. 
NULL string value 
The proper way to say that a string capability does not exist is to can- 
cel it. 
Very long string found. Missing comma? 
Self-explanatory 


Unknown option. Usage is: 
An invalid option was entered. 


Too many file names. Usage is: 
Self-explanatory 


“»" non-existent or permission denied 
The given directory could not be written into. 


"\." is not a directory 
Self-explanatory 
"."t Permission denied 
Access denied. 
"4": Not a directory 


tic wanted to use the given name as a directory, but it already exists 
as a file. 


SYSTEM ERROR!! Fork failed!!! 
A fork(2) failed. 


Error in following up use-links. Either there is a loop in the links or they ref- 
erence non-existent terminals. The following is a list of the entries involved: 


A terminfo(4) entry with a use=name capability either referenced a 
non-existant terminal called name, or name somehow referred back to 
the given entry. 


WARNINGS 


BUGS 
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Total compiled entries cannot exceed 4096 bytes. The name field cannot 
exceed 128 bytes. 


Terminal names exceeding 14 characters will be truncated to 14 characters 
and a warning message will be printed. 


When the -c option is used, duplicate terminal names will not be diagnosed; 
however, when -c is not used, they will be. 


To allow existing executables from the previous release of the UNIX System to 
continue to run with the compiled terminfo entries created by the new ter- 
minfo compiler, canceled capabilities will not be marked as canceled within 
the terminfo binary unless the entry name has a ‘+’ within it. (Such terminal 
names are only used for inclusion within other entries viaa use= entry. Such 
names would not be used for real terminal names.) 
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For example: 
4415+nl, kf1@, kf2@, 


4415+base, kf1l=\EOc, kf2=\EOd, .... 


4415-n1|/4415 terminal without keys, 
use=4415+nl, use=4415+base, 


The above example works as expected; the definitions for the keys do not show 
upinthe 4415-nlentry. However, ifthe entry 4415+n1 did not have a plus 
sign within its name, the cancellations would not be marked within the com- 
piled file and the definitions for the function keys would not be canceled 
within 4415-nl. 
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NAME 
time, ptime — time a command 


SYNOPSIS 
time [ -a J [-r ] [ -v ] command 


ptime [ -a ] [ -r ] [-v ] command 


DESCRIPTION 
The given command is executed; after it is complete, time prints the elapsed 
time during the command, the time spent in the system, and the time spent in 
execution of the command. Times are reported in seconds. 


If the —a option is specified, or when invoked as ptime, time shows the execu- 
tion times for each process. 


If the -r option is specified, tine also includes resource usage information. 

The resource usage fields are: 

pid numerical user-id of process owner 

ppid numerical user-id of parent of process 

MaxRSS maximum real.memory (resident set) size (in 1024 byte units) 
" MajorPF major page faults 

MinorPF minor page faults 


Swaps count of process swaps 

blkI count of block input operations 
blkO count of block output operations 
Nsig count of signals received 

Vesw voluntary context switches 
Iesw involuntary context switches 


If the -v option is specified, time traces process events such as fork, exec, and 
exit as they occur. 
The times are printed on the diagnostic output stream. 
Time is a built-in command to csh(1), and ksk(1), with a different syntax and a 
different output format. This command is available as /bin/time to csh and 
ksh users. 

BUGS 
Due to the multiprocessing nature of the operating system, it is possible for 
the CPU time (user + system time) for the command to greatly exceed the real 
time, thus giving percentages greater than 100% for CPU utilization. 
The -a option returns a smaller number for the system time because it does 
not include the time used to exit the process. 
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NAME 
timex — time a command; report process data and system activity 

SYNOPSIS 
timex [options] command 

DESCRIPTION 
The given command is executed and the elapsed time, user time, and system 
time spent in execution are reported in seconds. Optionally, process account- 
ing data for the command and all of its children can be listed or summarized, 
and total system activity during the execution interval can be reported. The 


output of timex is written on standard error. The options for this command 
are as follows: 


-p _ List process accounting records for command and all its children. 
Suboptions f, h, k, m, r, and t modify the data items reported. The 
options are as follows: 


-f Print the fork/exec flag and system exit status columns in the 
output. 


-h Instead of mean memory size, show the fraction of total available 
CPU time consumed by the process during its execution. This 
“hog factor” is computed as: (total CPU time)elapsed time). 

-k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor (user time/(system-time + user time). 


+t Show separate system and user CPU times. The number of 
blocks read or written and the number of characters transferred 
are always reported. 


-o Report the total number of blocks read or written and total characters 
transferred by command and all of its children. 


-8 Report total system activity (not just that due to command) that 
occurred during the execution interval of command. All data items 
listed in sar(1) are reported. 


EXAMPLES 
Asimple example: timex -ops sleep 60 


A terminal session of arbitrary complexity can be measured by timing a sub- 


shell: 
timex -opskmt sh 
session commands 
EOT 
SEE ALSO 
sar(1) 
WARNING 


Process records associated with command are selected from the accounting file 
/usr /adm/|pacct by inference, since process genealogy is not available. Back- 
ground processes having the same user-id, terminal-id, and execution time 
window will be spuriously included. 
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NAME 
toc: dtoc, ttoc, vtoc — graphical table of contents routines 
SYNOPSIS 
dtoc [directory] 
ttoc mn-file 
vtoce [-cdhnimsvn] [TTOC file] 
DESCRIPTION . 
All of the commands listed below reside in /usr/bin/graf (see graphics(1G)). 
dtoc dtoc makes a textual table of contents, TTOC, of all subdirectories 
beginning at directory (directory defaults to .). The list has one entry 
per directory. The entry fields from left to right are level number, 
directory name, and the number of ordinary readable files in the 
directory. dtoc is useful in making a visual display of all or parts of 
a filesystem. The following will make a visual display of all the read- 
able directories under /: 
dtoc/ | vtoc | td 

ttoc Output is the table of contents generated by the .TC macro of mm(1) 
translated to TTOC format. The input is assumed to be an mm file 
that uses the .H family of macros for section headers (see the DOCU- 
MENTER’S WORKBENCH Software). If no file is given, the standard 
input is assumed. 

vtoe —_ vtoc produces a GPS describing a hierarchy chart from a TTOC. The 
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output drawing consists of boxes containing text connected in a tree 
structure. If no file is given, the standard input is assumed. Each 
TTOC entry describes one box and has the following form: 


id [line-weight,line-style] "text" [mark] 


id An alternating sequence of numbers and dots. The id 
specifies the position of the entry in the hierarchy. The 
id 0.is the root of the tree. 


line-weight Either: 
n, normal-weight 
m, medium-weight 
b, bold-weight 
line-style Either: 
so, solid-line 
do, dotted-line 
dd, dot-dash line 
da, dashed-liner 
Id, long-dashed 


text Acharacter string surrounded by quotes. The charac- 
ters between the quotes become the contents of the box. 
To include a quote within a box it must be escaped (\"). 


mark Acharacter string (surrounded by quotes if it contains 
spaces), with included dots being escaped. The string is 
put above the top right corner of the box. To include 
either a quote or a dot within a mark, it must be 
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escaped. 
Entry example: 1.1b,da "ABC" DEF 


Entries may span more than one line by escaping the newline (\new- 
line). 


Comments are surrounded by the /*,*/ pair. They may appear any- 


where in a TTOC. 

Options: 
c Use text as entered (default is all uppercase). 
d Connect the boxes with diagonal lines. 
hn Horizontal interbox space is n % of box width. 
i Suppress the box id. 
m Suppress the box mark. 
8 


‘Do not compact boxes horizontally. 
vn Vertical interbox space is n% of box height. 


SEE ALSO 
graphics(1G), gps(4) 
mm(1) in the DOCUMENTER’S WORKBENCH Technical Discussion and Refer- 
ence Manual 
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NAME 
touch — update access and modification times of a file 


SYNOPSIS. 
touch [ -amc ] [ mmddhhmnlyy] ] files 


DESCRIPTION 
touch causes the access and modification times of each argument to be 
updated. The filename is created if it does not exist. If no time is specified 
(see date(1)), the current time is used. The -a and —m options cause touch to 
update only the access or modification times respectively (default is -am). 
The -c option silently prevents touch from creating the file if it did not previ- 
ously exist. 


The return code from touch is the number of files for which the times could 
not be successfully modified (including files that did not exist and were not 
created). 

SEE ALSO 
date(1), utime(2) 
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NAME 
tplot — graphics filters 


SYNOPSIS 


tplot [ -Tterminal [ -e raster ] ] 


DESCRIPTION 
These commands read plotting instructions (see plot(4)) from the standard 
input and in general produce, on the standard output, plotting instructions 
suitable for a particular terminal. If no terminal is specified, the environment 
parameter $TERM (see environ(5)) is used. Known terminals are as follows: 


300 DASI 300. 

3800S DASI 300s. 

450 DASI 450. 

4014 Tektronix 4014. 

ver Versatec D1200A. This version of plot places a scan-converted image 
in /usr/tmp/raster$$ and sends the result directly to the plotter 
device, rather than to the standard output. The -e option causes a 
previously scan-converted file raster to be sent to the plotter. 

FILES 

/usr/ib/t300 

/usr/ib/t300s 

/usr/ib/t450 

Ausr/lib/t4014 

/usr/lib/vplot 

/usr/tmp/raster$$ 


SEE ALSO 
plot(3X), plot(4), term(5) 
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NAME 


tput — initialize a terminal or query terminfo database . 


SYNOPSIS 


tput [-Ttype] capname [parms ...] 
tput [-Ttype] init 

tput [-Ttype] reset 

tput [-Ttype] longname 

tput -S << file 


DESCRIPTION 
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tput uses the terminfo(4) database to make the values of terminal-dependent 
capabilities and information available to the shell (see sh(1)), to initialize or 
reset the terminal, or to return the long name of the requested terminal type. 
tput outputs a string if the attribute (capability name) is of type string, or an 
integer if the attribute is of type integer. If the attribute is of type boolean, 
tput simply sets the exit code (0 for TRUE if the terminal has the capability, 1 
for FALSE if it does not), and produces no output. Before using a value 
returned on standard output, the user should test the exit code ($?, see sh(1)) 
to be sure it is 0. (See EXIT CODES and DIAGNOSTICS below.) For a com- 
plete list of capabilities and the capname associated with each, see ter- 


* minfo(4). 


-Ttype Indicates the type of terminal. Normally this option is unneces- 
sary, because the default is taken from the environment variable 
TERM. If -T is specified, then the shell variables LINES and COL- 
UMNS will not be referenced. 


capname Indicates the attribute from the terminfo(4) database. 


parms If the attribute is a string that takes parameters, the arguments 
parms will be instantiated into the string. An all numeric argu- 
ment will be passed to the attribute as a number. 


-S Allows more than one capability per invocation of tput. The capa- 
bilities must be passed to tput from the standard input instead of 
from the command line (see example). Only one capname is 
allowed per line. The -S option changes the meaning of the 0 and 
1boolean and string exit codes (see EXIT CODES). 


init If the terminfo(4) database is present and an entry for the user’s 
terminal exists (see ~Ttype, above), the following will occur: (1)if 
present, the terminal’s initialization strings will be output (isl, 
is2, is3, if, iprog), (2) any delays (e.g., newline) specified in the 
entry will be set in the tty driver, (3) tabs expansion will be turned 
on or off according to the specification in the entry, and (4) if tabs 
are not expanded, standard tabs will be set (every 8 spaces). If an 
entry does not contain the information needed for any of the above 
activities, that activity will silently be skipped. 

reset Instead of putting out initialization strings, the terminal reset 
strings are output if present (rsl, rs2, rs, rf). If the reset strings 
are not present but initialization strings are, the initialization 
strings are output. Otherwise, reset acts identically to init. 
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longname If the terminfo(4) database is present and an entry for the user’s 
terminal exists (see -Ttype above), then the long name of the ter- 
minal will be put out. The long name is the last name in the first 
line of the terminal’s description in the terminfo(4) database (see 


term(5)). 


EXAMPLES 


FILES 


tput init 


tput -T5620 reset 


tput cup 00 


tput clear 


tput cols 

tput -T450 cols 
bold=tput smso° 
offbold=tput rmso 


tput he 
tput cup 23 4 


tput longname 


tput -S <<! 
> clear 
>cup 1010 
> bold 

>! 


/usr/lib/terminfo/?/* 
/usr/include/curses.h 
/usr/include/term.h 


/usr/lib/tabset/* 


Initialize the terminal according to the type of terminal 
in the environmental variable TERM. This command 
should be included in everyone’s .profile after the envi- 
ronmental variable TERM has been exported, as illus- 
trated on the profile(4) manual page. 


Reset an AT&T 5620 terminal, overriding the type of 
terminal in the environmental variable TERM. 


Send the sequence to move the cursor to row 0, column ' 
0 (the upper-left corner of the screen, usually known as 


the “home” cursor position). 


Echo the clear-screen sequence for the current termi- 
nal. 


Print the number of columns for the current terminal. 
Print the number of columns for the 450 terminal. 


Set the shell variables bold (to begin stand-out mode 
sequence) and offbold (to end standout mode 
sequence) for the current terminal. This might be fol- 
lowed by a prompt: 


echo "${bold}Please type in your name: 
${offbold)}\c" 


Set exit code to indicate if the current terminal is a 
hardcopy terminal. 


Send the sequence to move the cursor to row 23, col- 
umn 4. 


Print the long name from the terminfo(4) database for 
the type of terminal specified in the environmental 
variable TERM. 


This example shows tput processing several capabili- 
ties in one invocation. This example clears the screen, 
moves the cursor to position 10, 10, and turns on bold 
(extra bright) mode. The list is terminated by an excla- 
mation mark (!) on a line by itself. 


Compiled terminal description database 
curses(3X) header file 

terminfo(4) header file 

Tab settings for some terminals, in a format appro- 
priate to be output to the terminal (escape 
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sequences that set margins and tabs); for more 
information, see the "Tabs and Initialization” sec- 
tion of terminfo(4). 


SEE ALSO 


atty (1), tabs (1), profile(4), terminfo(4) 


DIAGNOSTICS 


If capname is of type boolean, a value of 0 is set for TRUE and 1 for FALSE 
unless the -S option is used. 


If capname is of type string, a value of 0 is set if the capname is defined for this 
terminal type (the value of capname is returned on standard output); a value 
of lis set if capname is not defined for this terminal type (a null value is 
returned on standard output). 


If capname is of type boolean or string and the -S option is used, a value of 0 is 
returned to indicate that all lines were successful. No indication of which line 
failed can be given so exit code 1 will never appear. Exit codes 2, 3, and 4 
retain their usual interpretation. 


If capname is of type integer, a value of 0 is always set, whether or not cap- 
name is defined for this terminal type. To determine if capname is defined for 
this terminal type, the user must test the value of standard output. A value of 
-1 means that capname is not defined for this terminal type. 


Any other exit code indicates an error; see DIAGNOSTICS, below. 


tput prints these error messages and sets the corresponding exit codes: 


@ DIAGNOSTICS 
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Exit Code Error Message 


0 -1 (capname is a numeric variable not specified in the 
terminfo(4) database for this terminal type, e.g. 

tput -T450 lines and tput -T2621 xmc) 

No error message is printed, see EXIT CODES, above 
Usage error 

Unknown terminal type or no terminfo(4) database 
Unknown terminfo(4) capability capname 
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NAME 
tr —translate characters 
SYNOPSIS 
tr [ -eds ] [ string] [ string2 ] ] 
DESCRIPTION 
tr copies the standard input to the standard output with substitution or dele- 
tion of selected characters. Input characters found in string] are mapped into 
the corresponding characters of string2. Any combination of the options -cds 


can be used: 

-c Complements the set of characters in string1 with respect to the uni- 
verse of characters whose ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in string!. 

-8 Squeezes all strings of repeated output characters that are in string2 


to single characters. 


The following abbreviation conventions can be used to introduce ranges of 
characters or repeated characters into the strings: 


[a-z] Stands for the string of characters whose ASCII codes run from char- 
acter a to character z, inclusive. 


[a*n] Stands for x repetitions ofa. If the first digit of n is 0, n is considered 
octal; otherwise, n is taken to be decimal. A zero or missing n is 
taken to be huge; this facility is useful for padding string2. 

The escape character (\) may be used as in the shell to remove special mean- 


ing from any character in a string. In addition, \ followed by 1, 2, or 8 octal 
digits stands for the character whose ASCII code is given by those digits. 


EXAMPLES 
The following example creates a list of all the words in file one per line in 
file2, where a word is taken to be a maximal string of alphabetics. The strings 
are quoted to protect the special characters from interpretation by the shell; 
012 is the ASCII code for newline. 

tr -cs "[A-Z][a-z]" "[\012]" <filel >file2 

SEE ALSO 
esh(1), ed(1), ksh(1), sh(1), ascii(5) 

BUGS 


Will not handle ASCII NUL in string] or string2; always deletes NUL from 
input. 


12/89 1 


DYNIX/ptx TRUE(1) 


NAME 
true, false — provide truth values 


SYNOPSIS 
true 


false 


DESCRIPTION 
true does nothing, successfully. false does nothing, unsuccessfully. They are 
typically used in input to sh(1), as in the following example: 


while true 
do 
command 
done 
SEE ALSO 
sh(1) 
DIAGNOSTICS 


true has exit status zero, false non-zero. 
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NAME 
tsort — topological sort 

SYNOPSIS 
tsort [file] 

DESCRIPTION 
The tsort command produces on the standard output a totally ordered list of 
items consistent with a partial ordering of items mentioned in the input file. 
If no file is specified, the standard input is understood. 


The input consists of pairs of items (nonempty strings) separated by blanks. 
Pairs of different items indicate ordering. Pairs of identical items indicate 
presence, but not ordering. 

SEE ALSO 
lorder(1) 


DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 
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NAME j 
© tty — get the name of the terminal 


SYNOPSIS 
tty [-l][-s] 


DESCRIPTION 
tty prints the pathname of the user’s terminal. The following options are 
available: 


-l Prints the synchronous line number to which the user’s terminal is 
connected, if it is on an active synchronous line. 


“8 Inhibits printing of the terminal pathname, allowing one to test just 
the exit code. 


DIAGNOSTICS 
not on an active synchronous line 


The standard input is not a synchronous terminal and -] is speci- 
fied. 


notatty The standard input is not a terminal and —s is not specified. 


EXIT CODES: 
2 Ifinvalid options were specified 
0 Ifstandard input is a terminal 


& 1 Otherwise 
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DYNIX/ptx TTYDEVNAME(1) 


NAME 
3 ttydevname — get the device associated with a terminal or the terminal associ- 
ated with a device 
SYNOPSIS 
ttydevname <ttypath> 


ttydevname <major> <minor> 

DESCRIPTION 
With one argument, ttydevname takes the basename of ttypath and prints 
the major and minor number of the device that would be returned by the 
ttyname library routine. 


Because only the basename of ttypath is used, an obviously bad path may still 
print a valid major and minor number. For example, the path 
/dev/hello/world/ ABCD would use only ABCD, which is a valid basename. 
To determine the major and minor device associated with your current termi- 
nal line, execute the following command: 


ttydevname “tty 
With two arguments, ttydevname prints the path associated with major and 
minor. 


DIAGNOSTICS 
invalid name 
The basename of ttypath is invalid. The basename must contain four 
: © characters; each character must be in the range [A-Za-z0-9_+]. 
SEE ALSO 
tty(1), dev_to_ttyname(3C), ttyname(3C) 
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NAME 
@ tunefs — tune up an existing filesystem 
SYNOPSIS . 
/etc/tunefs tuneup-options special | filesys 
DESCRIPTION 
tunefs is designed to change the dynamic parameters of a filesystem which 
effect layout policies. The parameters are as follows: 
-a maxcontig 
The maximum number of contiguous blocks that are laid out before 
forcing a rotational delay (see -d). The default value is one, since most 
device drivers require an interrupt per disk transfer. Device drivers 
that can chain several buffers together in a single transfer should set 
this to the maximum chain length. 
-d rotdelay 
The expected time (in milliseconds) to service a transfer completion 
interrupt and initiate a new transfer on the same disk. It is used to 
decide how much rotational spacing to place between successive blocks 
in a file. 
-e maxbpg 
The maximum number of blocks a one file that can be allocated out of 
a cylinder group before it is forced to begin allocating blocks from 
another cylinder group. Typically, this is one-fourth of the number of 
blocks in a cylinder group. This prevents all of the blocks in a single 
i) cylinder group from being allocated to one file, which degrades the 
access time for all other files allocated to that cylinder group. This 
increases the number of long seeks on large files. For filesystems with 
large files exclusively, maxbpg should be set higher. 
-m minfree 
The percentage of space withheld from normal users; the minimum 
free-space threshold. The default value is 10%. This value can be set 
to zero; however, throughput at a level of zero is approximately one- 
third of the throughput at a 10% threshold. Note that if the value is 
raised above the current usage level, users will be unable to allocate 
files until enough files have been deleted to get under the higher 
threshold. 
SEE ALSO 
newfs(1M), mkfs(1M), fa(4) 
BUGS 
tunefs should work on mounted and active filesystems. Because the super- 
block is not kept in the buffer cache, the changes take effect only if tunefs is 


run on dismounted filesystems. If tunefs is run on the root filesystem, the 
system must be rebooted. 
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DYNIX/ptx UADMIN(1M) 


NAME 
} uadmin — administrative control 


SYNOPSIS 
/etc/uadmin cmd fen [mdep] 


DESCRIPTION 
The uadmin command provides control for basic administrative functions. 
This command is tightly coupled to the System Administration procedures and 
is not intended for general use. Use of this command may produce unexpected 
results. It may be invoked only by the superuser. 


The arguments cmd (command), fen (function) and, optionally, mdep (machine- 
dependent argument) are converted to integers and passed as the first, second 

and third arguments to the uadmin system call. All online processors are off- 
lined before making the call. 


For example, uvadmin 2 0 will kill all processes, unmount the root filesystem 
and return to firmware. uadmin 1 4 4 will return to firmware immediately, 
without flushing the buffer cache out to disk, or killing all processes, or 
unmounting the root filesystem. 


SEE ALSO 
uadmin(2) 


WARNINGS 
Only one uadmin command at a time may run on the operating system. uad- 
min commands are found in the inittab file. 


@ If a uadmin command is present in an rc file, the error message uadmin: 
invalid argument may be issued. This is because the operating system may be pro- 
cessing one uadmin command when the next is encountered, causing execu- 
tion of the commands to overlap. If any of the rc files contain uadmin com- 
mands, make sure that the inittab file does not also contain a uadmin com- 
mand that executes at the same run level. 
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@ NAME 


umask — set file-creation mode mask 


SYNOPSIS 


umask [ 000 J 


DESCRIPTION 


The user file-creation mode mask is set to ooo. The three octal digits refer to 
read/write/execute permissions for owner , group, and others, respectively (see 
chmod(2) and umask(2)). The value of each specified digit is subtracted from 
the corresponding “digit” specified by the system for the creation of a file (see 
creat(2)). For example, umask 022 removes group and others write permis- 
sion (files normally created with mode 777 become mode 755; files created 
with mode 666 become mode 644). 


If 000 is omitted, the current value of the mask is printed. 
umask is recognized and executed by the shell. 


For Bourne and Korn shell users, umask can be included in the user’s .profile 
(see profile(4)) and invoked at login to automatically set the user’s permis- 
sions on files or directories created. For C shell users, umask can be included 
in the user’s .login file. 


SEE ALSO 
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chmod(1), esh(1), ksh(1), sh(1), chmod(2), creat(2), umask(2), profile(4) 


DYNIX/ptx UNAME(1) 


NAME 
uname — print name of current system 


SYNOPSIS 
uname [ -snrvma ] 
uname [ -S system name ] 


DESCRIPTION 
uname prints the current system name on the standard output file. It is 
mainly useful to determine which system one is using. The options cause 
selected information returned by uname(2) to print: 


-8 Print the system name (default). 


—n Print the nodename (the nodename is the name by which the system is 
known to a communications network). 


+r Print the operating system release. 
-v Print the operating system version. 
-m Print the machine hardware name. 
-a Print all of the above information. 


The system name and the nodename may be changed by specifying a system 
name argument to the -S option. The system name argument is restricted to 
8 characters. Only the superuser is allowed this capability. 

SEE ALSO 
uname(2) 
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DYNIX/ptx UNGET(1) 


NAME 
& unget — undo a previous get of an SCCS file 


SYNOPSIS 
unget [-rSID] [-s] [-n] files 


DESCRIPTION 
unget undoes the effect of a get -e done prior to creating the intended new 
delta. If a directory is named, unget behaves as though each file in the direc- 
tory were specified as a named file, except that non-SCCS files and unreadable 
files are silently ignored. If a name of —is given, the standard input is read 
with each line being taken as the name of an SCCS file to be processed. 


Keyletter arguments apply independently to each named file. 


-rSID Uniquely identifies which delta is no longer intended. (This would 
have been specified by get as the “new delta”). The use of this 
keyletter is necessary only if two or more outstanding gets for editing 
on the same SCCS file were done by the same person (login name). A 
diagnostic results if the specified SID is ambiguous, or if it is necessary 
and omitted on the command line. 


8 Suppresses the printout, on the standard output, of the intended 
delta’s SID. 


—n Causes the retention of the gotten file which would normally be 
removed from the current directory. 


SEE ALSO 
) delta(1), get(1), help(1), sact(1) 


DIAGNOSTICS 
Use help(1) for explanations. 
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NAME 


UNIQ(1) 


uniq — report repeated lines in a file 


SYNOPSIS 


uniq [ -ude [ +n ][-n ] ] [ input [ output ] ] 


DESCRIPTION 


uniq reads the input file and compares adjacent lines. In the normal case, the 
second and succeeding copies of repeated lines are removed; the remainder is 
written on the output file. input and output should always be different. Note 
that repeated lines must be adjacent in order to be found; see sort(1). If the 
-u flag is used, just the lines that are not repeated in the original file are out- 
put. The -d option specifies that one copy of just the repeated lines is to be 
written. The normal mode output is the union of the -u and -d mode outputs. 


The -c option supersedes -u and -d and generates an output report in default 
style but with each line preceded by a count of the number of times it 
occurred. : 


The n arguments specify skipping an initial portion of each line in the compar- 
ison: 


—n The first n fields together with any blanks before each are ignored. A 
field is defined as a string of non-space, non-tab characters separated 
by tabs and spaces from its neighbors. 


+n The first n characters are ignored. Fields are skipped before charac- 
ters. 


SEE ALSO 
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comm(1), sort(1) 


DYNIX/ptx UNITS(1) 


NAME 


units — conversion program 


SYNOPSIS 


units 


DESCRIPTION 


FILES 
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units converts quantities expressed in various standard scales to their equiv- 
alents in other scales. It works interactively in this fashion: 


You have: inch 

You want: cm 
* 2.540000e+00 
/38.937008e—-01 


A quantity is specified as a multiplicative combination of units optionally pre- 
ceded by a numeric multiplier. Powers are indicated by suffixed positive inte- 
gers, division by the usual sign. 
You have: 15]bs force/in2 
You want: atm 
* 1.020689e+00 
/9.797299e-01 


units only does multiplicative scale changes; thus it can convert Kelvin to 
Rankine, but not Celsius to Fahrenheit. Most familiar units, abbreviations, 
and metric prefixes are recognized, together with a generous leavening of exo- 
tica and a few constants of nature including the following: 


pi Ratio of circumference to diameter 
¢ Speed of light 

e Charge on an electron 

g Acceleration of gravity 


force Same as g 

mole Avogadro’s number 

water Pressure head per unit height of water 
au Astronomical unit ‘ 


Pound is not recognized as a unit of mass; Ib is. Compound names are run 
together, (e.g., lightyear). British units that differ from their U.S. counter- 


parts are prefixed thus: brgallon. For a complete list of units, type this com- 
mand: 


cat /usr/lib/unittab 


/usr/lib/unittab 


DYNIX/ptx UPTIME(1) 


NAME 
uptime — show how long system has been up 

SYNOPSIS 
uptime 

DESCRIPTION 
uptime prints the current time, the length of time the system has been up, 
and the average number of jobs in the run queue over the last 1, 5 and 15 min- 
utes. 


FILES 
/unix system name list 


DYNIX/ptx USAGE(1) 


NAME 

usage — retrieve a command description and usage examples 
SYNOPSIS 

[ help ] usage [ -d ] [ -e ] [-o ] [ command_name ] 
DESCRIPTION 


The Help Facility usage command retrieves information about operating sys- 
tem commands. With no argument, usage displays a menu that prompts the 
user for the name of a command, or allows the user to retrieve a list of com- 
mands supported by usage. The user may also exit to the shell by typing q 
(for “quit”). 


After a command is selected, the user is asked to choose either a description of 
the command, examples of typical usage of the command, or descriptions of the 
command’s options. Then, based on the user’s request, the appropriate infor- 
mation will be printed. 


Acommand name may also be entered at shell level as an argument to usage. 
To receive information on the command’s description, examples, or options, 
the user can use the ~d, ~e, or -o options respectively. (The default option is 
-d.) 


From any screen in the Help Facility, a user can execute a command via the 
shell by typing an exclamation mark (!) and the command. The screen will be 
redrawn if the command was entered at a first-level prompt. If the command 
is entered at any other prompt level, only the prompt will be redrawn. 


By default, the Help Facility scrolls the data that is presented to the user. If 
you prefer to have the screen clear before printing the data (non-scrolling), the 
shell variable SCROLL must be set to no and exported so it will become part 
of your environment. This is done by adding the following line to your .profile 
file (see profile(4)): “export SCROLL ; SCROLL=no”. Ifyou later decide that 
scrolling is desired, SCROLL must be set to yes. 


Information on each of the Help Facility commands (starter, locate, usage, 
glossary, and help) is located on their respective manual pages. 


SEE ALSO 
cesh(1), glossary(1), help(1), ksh(1), locate(1), sh(1), starter(1), term(5) 


WARNINGS 
If the shell variable TERM (see sh(1)) is not set in the user’s .profile file, then 
TERM will default to the terminal value type 450 (a hard-copy terminal). For 
a list of valid terminal types, refer to term(5). 
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DYNIX/ptx UUCHECK(1M) 


NAME 


uucheck — check the uucp directories and permissions file 


SYNOPSIS 


Ausr/lib/uucp/uucheck [ -v ] [ -x debug_level ] 


DESCRIPTION 


FILES 


uucheck checks for the presence of the uucp system required files and direc- 
tories. Within the uucp makefile, it is executed before the installation takes 
place. It also checks for some obvious errors in the Permissions file 

(/usr/lib/ uucp/ Permissions). When executed with the —v option, it gives a 
detailed explanation of how the uucp programs will interpret the Permissions 
file. The -x option is used for debugging. debug-option is a single digit in the 
range 1-9; the higher the value, the greater the detail. 


Note that uucheck can be used only by the superuser or uucp. 


/usr/lib/uucp/Systems 
/Ausr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuscheds 
Ausr/fib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 


SEE ALSO 


BUGS 
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uucp(1C), uustat(1C), uux(1C), uucico(1M), uusched(1M) 


The program does not check file/directory modes or some errors in the Permis- 
sions file such as duplicate login or machine name. 


DYNIX/ptx UUCICO(1M) 


NAME 


uucico — file transport program for the uucp system 


SYNOPSIS 


Ausr/lib/uucp/uucico [ -r role_number ] [ -x debug_level ] 
[ -i interface ] [ -d spool_directory ] -s system_name 


DESCRIPTION 


FILES 


uucico is the file transport program for uucp work file transfers. Role num- 
bers for the -r option are the digit 1 for master mode or 0 for slave mode 
(default). The -r option should be specified as the digit 1 for master mode 
when uucico is started by a program or cron. uux and uucp both queue jobs 
that will be transferred by uucico. It is normally started by the scheduler, 
uusched, but can be started manually; this is done for debugging. For 
example, the shell Uutry starts uucico with debugging turned on. A single 
digit must be used for the -x option with higher numbers for more debugging. 


The -i option defines the interface used with uucico. This interface only 
affects slave mode. Known interfaces are UNIX (default), TLI (basic Trans- 
port Layer Interface), and TLIS (Transport Layer Interface with Streams 
modules, read/write). 


The -d option is used to specify the directory (spool_directory) containing the 
work files to be transferred. The default spool directory is /usr/spool /uucp. 
The -s option defines the system (system_name) that uucico will try to con- 

tact. The system_name must be defined in the Systems file. 


/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Devconfig 
/usr/lib/uucp/Sysfiles 
/usr/lib/uucp/Maxuuxqts 
/usr/fib/uucp/Maxuuscheds 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 


" SEE ALSO 
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cron(1M), uucp(1C), uusched(1M), uustat(1C), uutry(1M), uux(1C) 


DYNIX/ptx UUCLEANUP(1M) . 


NAME 
uucleanup — uucp spool directory clean-up 

SYNOPSIS 
fusr/lib/uucp/uucleanup [ —Ctime ] [ -Wtime ] [ -Xtime ] [ -mstring ] 
[ -otime ] [ -esystem ] 


DESCRIPTION 
uucleanup will scan the spool directories for old files and take appropriate 
action to remove them in a useful way: 


Inform the requestor of send/receive requests for systems that cannot 
be reached. 


Return mail that cannot be delivered to the sender. 


Delete or execute rnews for rnews type files (depending on where the 
news originated—locally or remotely). 


Remove all other files. 


In addition, there is provision to warn users of requests that have been wait- 
ing for a given number of days (default 1). Note that uucleanup will process 
as if all option times were specified to the default values unless time is specifi- 
cally set. 


The following options are available. 


-Ctime Any C. files greater or equal to time days old will be removed with 
appropriate information to the requestor. (Default 7 days.) 


-Dtime Any D. files greater or equal to time days old will be removed. An 
attempt will be made to deliver mail messages and execute rnews 
when appropriate. (Default 7 days.) 


-Wtime Any C. files equal to time days old will cause a mail message to be 
sent to the requestor warning about the delay in contacting the 
remote. The message includes the JOBLD, and in the case of mail, 
the mail message. The administrator may include a message line 
telling who to call to check the problem (-m option). (Default 1 
day.) 

-Xtime AnyX. files greater or equal to time days old will be removed. The 
D. files are probably not present (if they were, the 2. could get exe- 
cuted). But if there are D. files, they will be taken care of by D. pro- 
cessing. (Default 2 days.) 


-mstring This line will be included in the warning message generated by the 
-W option. 


-otime Other files whose age is more than time days will be deleted. 
(Default 2 days.) The default line is See your local adminis- 
trator to locate the problem 


-ssystem Execute for system spool directory only. 


~xdebug_level 
The -x debug level is a single digit between 0 and 9; higher num- 
bers give more detailed debugging information. (If uucleanup was 
compiled with -DSMALL, no debugging output will be available.) 
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This program is typically started by the shell uudemon.cleanup, which 
should be started by cron(]M). @ 


FILES 
/usr/lib/uucp Directory with commands used by uucleanup inter- 
nally 


/usr/spool/uucp Spool directory 


SEE ALSO 
uucp(1C), uux(1C), cron(1M) 
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DYNIX/ptx UUCP(1C) 


NAME 
uucp, uulog, uuname — UNIX-to-UNIX system copy 

SYNOPSIS 
uucp [ options ] source-files destination-file 
uulog [ options ] -ssystem 
uulog [ options ] system 
uulog [ options ] -fsystem 
uuname [ -1 ] [ -c ] 

DESCRIPTION 

uucp 
uucp copies files named by the source-file arguments to the destination-file 
argument. A filename can be a pathname on your machine, or can have this 
form: 
system-name!pathname 


system-name is taken from a list of system names that uucp knows about. 
The system-name can also be a list of names such as the following: 
system-name!system-namel...'system-name!pathname 
In this case, an attempt is made to send the file to the destination via the 
specified route. See WARNINGS and BUGS below for restrictions. Care 
should be taken to ensure that intermediate nodes in the route are willing to 
foward information (see WARNINGS below for restrictions). 
The following shell metacharacters are disallowed in system-name: 
“3; & 1* <> () <CR> <TAB> <SPACE> 
Pathnames may be one of the following: 
(1) A full pathname. 


(2) Apathname preceded by “user where user is a login name on the speci- 
fied system and is replaced by that user’s login directory. 


(3) Apathname preceded by “/destination where destination is appended to 
/ usr / spool / uucppublic. 


(NOTE: This destination will be treated as a filename unless more than 
one file is being transfered by this request or the destination is already a 
directory. To ensure that it is a directory, follow the destination with a 
slash (/). For example “/dan/ as the destination will create the directory 
/usr/ spool / uucppublic/dan if it does not exist and put the requested 
file(s) in that directory). 

(4) Anything else is prefixed by the current directory. 

If the result is an erroneous pathname for the remote system, the copy will 

fail. If the destination-file is a directory, the last part of the source-file name is 

used. 

uuep preserves execute permissions across the transmission and gives 0666 

read and write permissions (see chmod(2)). 


The following options are interpreted by uucp: 
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-c Do not copy local file to the spool directory for transfer to the 
remote machine (default). @ 
—-C Force the copy of local files to the spool directory for transfer. 
-d Make all necessary directories for the file copy (default). 
-f Do not make intermediate directories for the file copy. 


-gerade Grade isa single letter/number; lower ASCII sequence characters 
will cause the job to be transmitted earlier during a particular con- 
versation. 

Jj Output the job identification ASCII string on the standard output. 
This job identification can be used by uustat to obtain the status 
or terminate a job. 


-m Send mail to the requester when the copy is completed. 

-nuser Notify user on the remote system that a file was sent. 

-r Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer to file. Note that the file must be a full 
pathname. 

~xdebug_level 


Produce debugging output on standard output. The debug_level is 
a number between 0 and 9; higher numbers give more detailed 
information. (Debugging will not be available if uucp was com- 


piled with -DSMALL.) 
uulog: © 


uulog queries /usr/spool /uucp/.Log /uucico/system (the uucp transactions 
log file) and /usr/spool / uucp /.Log /uuxgt/ system (the uuxqt transactions log 
file). 


The options cause uulog to print logging information: 
-ssy8 Print information about file transfer work involving system sys. 


-fsystem Does a tail -f of the file transfer log for system. (You must press 
Break to exit this function.) Other options used in conjunction with 
the above: 


-x Look in the uuxqt log file for the given system. 
-number Indicates that a tail command of number lines should be executed. 


uuname: 
uuname lists the names of systems known to uucp. The -c option returns 
the names of systems known to cu. (The two lists are the same, unless your 
machine is using different Systems files for cu and uucp. See the Sysfiles 
file.) The -1 option returns the local system name. 


FILES 
/usr/spool/uucp Spool directories 
/usr/spool/uucppublic/# Public directory for receiving and 
sending (/usr/spool / uucppublic) 
/usrfib/uucp/* Other data and program files 
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& SEE ALSO 


mail(1), uustat(1C), uux(1C), uuxqt(1M), chmod(2) 


WARNINGS 


BUGS 
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The domain of remotely accessible files can (and for obvious security reasons, 
usually should) be severely restricted. You will very likely not be able to fetch 
files by pathname; ask a responsible person on the remote system to send 
them to you. For the same reasons, you will probably not be able to send files 
to arbitrary pathnames. As distributed, the remotely accessible files are those 
whose names begin /usr/spool / uucppublic (equivalent to “/). 


All files received by uucp will be owned by uucp. 


The -m option works only to send files or receive a single file. Receiving mul- 
tiple files specified by special shell characters ? * [...] will not activate the 
-m option. 


The forwarding of files through other systems may not be compatible with the 


previous version of uucp. If forwarding is used, all systems in the route must 
have the same version of uucp. 


Protected files and files that are in protected directories owned by the reques- 
tor can be sent via uucp by using the -C option. However, if the requestor is 
root and the directory is not searchable by “other” or the file is not readable 
by “other,” the request will fail. 


DYNIX/ptx UUGETTY(1M) 


NAME 
uugetty — set terminal type, modes, speed, and line discipline 

SYNOPSIS. 
/usr/lib/uucp/uugetty [-t timeout] [-r] line [speed [type [linedisc] ] ] 
fusr/lib/uucp/uugetty -c file 

DESCRIPTION 
uugetty is identical to getty(1M), but changes have been made to support 
using the line for uucico, cu, and ct; that is, the line can be used in both 
directions. The uugetty will allow users to login, but if the line is free, 
uucico, cu, or ct can use it for dialing out. The implementation depends on 
the fact that uucico, cu, and ct create lock files when devices are used. 
When the "open()" returns (or the first character is read when the -r option is 
used), the status of the lock file indicates whether the line is being used by 
uucico, cu, ct, or someone trying to login. Note that in the —-r case, several 
<carriage-return> characters may be required before the login message is out- 
put. The human ueers will be able to handle this slight inconvenience. 
uucico trying to log in will have to be told by using the following login script: 

™ Ar\d\r\d\r\d\r in:--in:... 

The ... is whatever would normally be used for the login sequence. 


If there is a uugetty on one end of a direct line, there must be a uugetty on 
the other end as well. Here is an /etc/inittab entry using uugetty on an 
intelligent modem or direct line: 


30:2:respawn:/usr/lib/uucp/uugetty-r -t 60 ttyGA/GAAH 1200 
The meanings of the available options are as follows: 
-ttimeout Specifies that uugetty should exit if the open on the line suc- 


ceeds and there is no response to the login prompt in timeout 
seconds. timeout is replaced by an integer. 


-r Causes uugetty to wait to read a character before it puts out 
the login message, thus preventing two uugettys from looping. 
An entry for an intelligent modem or direct line that has a 
uugetty on each end must use this option. 


line Defines the name of the line to which uugetty will attach itself. 
The line name will point to an entry in the /dev directory. For 
example, /dev/ttyGA/GAAB. 

speed Defines the entry to use from the /etc/gettydefs file. The entry 


defines the line speed, the login message, the initial tty setting, 
and the next speed to try if the user says the speed is inappro- 
priate (by sending a break character). The default speed is 300. 


type Defines the type of terminal connected to the line. The default 
terminal is none, representing a normal terminal unknown to 
the system (see getty(1M)). 

linedisc Sets the line discipline to use on the line. The default is line 
discipline 0, which is the only one currently compiled into the 
operating system. 
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-c file Checks the speed and tty definitions in file and sends the results 
to standard output. Unrecognized modes and improperly con- 
structed entries are reported. For correct entries, flag values 
are printed. file is replaced by /etc/gettydefs or a similarly 
structured file. 

FILES 
/ete/gettydefs 
/etc/issue 


SEE ALSO 
ct(1C), cu(1C), getty(1M), init(1M), login(1) uucico(1M), ioctl(2), gettydefs(4), 
inittab(4), tty(7) 

BUGS 


ct will not work when uugetty is used with an intelligent modem such as pen- 
ril or ventel. 
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@ NAME 


uusched — the scheduler for the uucp file transport program 


SYNOPSIS 


Aasr/lib/uucp/uusched [ -x debug_level ] [ -u debug_level ] 


DESCRIPTION 


FILES 


uusched is the uuep file transport scheduler. It is usually started by the 
daemon uudemon.hour that is started by cron(1M) from an entry in 
/usr/spool/cron/crontab: 

39 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour > 
/dev/null" 


The two options are for debugging purposes only: -x debug_level will output 
debugging messages from uusched and —u debug_level will be passed as -x 
debug_level to uucico. The debug_level is a number between 0 and 9; higher 
numbers give more detailed information. 


/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/ib/uucp/Devices 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 


SEE ALSO 
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uucp(1C), uustat(1C), uux(1C), cron(1M), uucico(1M) 


DYNIX/ptx UUSTAT(1C) 


NAME 


uustat — uucp status inquiry and job control 


SYNOPSIS 


uustat [-a] 

uustat [-m] 

uustat [-p] 

uustat [-q] 

uustat [ -kjobid ] 

uustat [ -rjobid ] 

uustat [ -ssystem ] [ -uuser ] 


DESCRIPTION 
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uustat will display the status of previously specified uucp commands, cancel 
previous uucp commands, or provide general status on uucp connections to 
other systems. Only one of the following options can be specified with uustat 
per command execution: 


-a _ Output all jobs in queue. 
-m_ Report the status of accessibility of all machines. 


_ ~p Execute a ps -fIp for all the process-ids that are in the lock files. 


-q _ List the jobs queued for each machine. Ifa status file exists for the 
machine, its date, time and status information are reported. In addi- 
tion, if a number appears in () next to the number of C or X files, it is 
the age in days of the oldest C./X. file for that system. The Retry field 
represents the number of hours until the next possible call. The Count 
is the number of failure attempts. NOTE: For systems with a moderate 
number of outstanding jobs, this could take 30 seconds or more of real- 
time to execute. The following example shows output produced by the 


-q option: 
eagle 3c 04/07-11:07 NO DEVICES AVAILABLE 
mh3bs3 2c 07/07-10:42 SUCCESSFUL 


The above output tells how many command files are waiting for each system. 
Each command file may have zero or more files to be sent (zero means to call 
the system and see if work is to be done). The date and time refer to the previ- 
ous interaction with the system followed by the status of the interaction. 


-kjobid Kill the uucp request whose job identification is jobid. The killed 
uucp request must belong to the person issuing the uustat com- 
mand unless one is the superuser. 


-rjobid Rejuvenate jobid. The files associated with jobid are touched so that 
their modification time is set to the current time. This prevents the 
cleanup daemon from deleting the job until the jobs modification 
time reaches the limit imposed by the deamon. 


Either or both of the following options can be specified with uustat: 
-ssys Report the status of all uucp requests for remote system sys. 
-uuser Report the status of all uucp requests issued by user. 
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FILES 


Output for both the -s and -u options has the following format: 


eaglen0000 4/07-11:01:03 (POLL) 

eagleNlbd7 4/07-11:07 Seagledan522 /usr/dan/A 

eagleClbd8 4/07-11:07 Seagledan59 D.3b2al2ce4924 
4/07-11:07 Seagledanrmail mike 


With the above two options, the first field is the jobid of the job. This is fol- 
lowed by the date/time. The next field is either an S or an R depending on 
whether the job is to send or request a file. This is followed by the user-id of 
the user who queued the job. The next field contains the size of the file, or in 
the case of a remote execution (rmail—the command used for remote mail), 
the name of the command. When the size appears in this field, the filename is 
also given. This can be either the name given by the user or an internal name 
(such as D.3b2alce4 924) that is created for data files associated with remote 
executions (rmail in this example). : 


When no options are given, uustat outputs the status of all uucp requests 
issued by the current user. 


/usr/spool/uucp/* Spool directories 


SEE ALSO 


uucp(1C) 


12/89 


DYNIX/ptx UUTO(1C) 


NAME 


uuto, uupick — public UNIX-to-UNIX system file copy 


SYNOPSIS 


uuto [ options ] source-files destination 
uupick [ -s system ] 


DESCRIPTION 
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uuto sends source-files to destination. uuto uses the uucp(1C) facility to 
send files, while it allows the local system to control the file access. A source- 
file name is a pathname on your machine. Destination has the form: 


systemluser 


system is taken from a list of system names that uucp knows about (see 
uuname). user is the login name of someone on the specified system. 


Two options are available: 
-p Copy the source file into the spool directory before transmission. 
-m Send mail to the sender when the copy is complete. 


The files (or sub-trees if directories are specified) are sent to PUBDIR on sys- 
tem, where PUBDIR is a public directory defined in the uucp source. By 
default this directory is /usr/spool /uucppublic. Specifically the files are sent 
to: 

PUBDIR| receive / user | mysystem | files 
The destined recipient is notified by mail(1) of the arrival of files. 
uupick accepts or rejects the files transmitted to the user. Specifically, 


uupick searches PUBDIR for files destined for the user. For each entry (file or 
directory) found, the following message is printed on the standard output: 


fromsystem: [file file-name] [dirdirname] ? 


uupick then reads a line from the standard input to determine the disposi- 
tion of the file: 


newline Go to next entry. 
d Delete the entry. 


m [dir ] Move the entry to named directory dir. If dir is not specified as 
a complete pathname (in which $HOME is legitimate), a destina- 
tion relative to the current directory is assumed. If no destina- 
tion is given, the default is the current directory. 


al[dir] Same as m, except moves all files sent from system. 
p Print the content of the file. 
q Stop. 


EOT (Ctrl-D) Same as q. 
lcommand Escape to the shell to do command. 
* Print a command summary. 


uupick invoked with the -ssystem option will search only the PUBDIR for files 
sent from system. 
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FILES 

PUBDIR /usr/spool/uucppublic public directory 
SEE ALSO 

mail(1), uucp(1C), uustat(1C), uux(1C), uucleanup(1M) 
WARNINGS 


To send files that begin with a dot (such as.profile) the files must by qualified 
with a dot. For example: .profile, .prof*, .profil? are correct; whereas *prof*, 
?profile are incorrect. 
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@ NAME 


Uutry — try to contact remote system with debugging on 


SYNOPSIS 


fasr/lib/uucp/Uutry [ -x debug_level ] [ -r ] system_name 


DESCRIPTION 


FILES 


Uutry is a shell that. is used to invoke uucico to call a remote site. Debug- 
ging is turned on (default is level 5); -x will override that value. The -r over- 
rides the retry time in /usr/spool /uucp/.status. The debugging output is put 
in file /tmp/system_name. A tail -f of the output is executed. A Delete or 
Break character will give control back to the terminal while the uucico con- 
tinues to run, putting its output in /tmp/system_name. 


/usr/ib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuxqts 
/usr/lib/uucp/Maxuuscheds 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 
/tmp/system_name 


SEE ALSO 
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uucp(1C), uux(1C), uucico(1M) 


DYNIX/ptx UUX(1C) 


NAME 


uux — UNIX-to-UNIX system command execution 


SYNOPSIS . 


uux [ options ] command-string 


DESCRIPTION 
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uux will gather zero or more files from various systems, execute a command 
on a specified system, and then send standard output to a file on a specified 
system. 


NOTE: For security reasons, most installations limit the list of commands 
executable on behalf of an incoming request from uux, permiting only the 
receipt of mail (see mail(1)). (Remote execution permissions are defined in 
/usr/lib/uucp/ Permissions .) 


The command-string is made up of one or more arguments that look like a 
shell command line, except the command and filenames can be prefixed by sys- 
tem-namel. A null system-name is interpreted as the local system. 


Filenames may be one of the following: 
(1) A full pathname 


(2) Apathname preceded by “xxx where xxx is a login name on the specified 
system and is replaced by that user’s login directory. 


(3) Anything else is prefixed by the current directory. 

As an example, the following command gets file] from the usg machine and 
file2 from the pwba machine, executes a diff(1) command, and put the results 
in file.diffin the local PUBDIR/dan/ directory. 

uux "Idiff usg!/usr/dan/filel pwba!/a4/dan/file2 > 1/dan/file.diff" 


Any special shell characters such as <>;| should be quoted either by quoting 
the entire command-string or by quoting the special characters as individual 
arguments. 
uux will attempt to get all files to the execution system. For files that are 
output files, the filename must be escaped by using parentheses. For example, 
the following command gets /usr/file from system b and sends it to system a, 
performs a cut command on that file, and sends the result of the cut com- 
mand to system c. 

uux alcut -fl b!/usr/file \(cl/usr/file\) 


uux will notify you if the requested command on the remote system was disal- 

lowed. This notification can be turned off by the -n option. The response 

comes by remote mail from the remote machine. 

The following options are interpreted by uux: 

= The standard input to uux is made the standard input to the com- 
mand-string. 

-aname Use name as the user identification replacing the initiator user-id. 
(Notification will be returned to the user.) 


-b Return whatever standard input was provided to the uux com- 
mand if the exit status is non-zero. 
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FILES 


-c Do not copy local file to the spool directory for transfer to the 
remote machine (default). 
-C Force the copy of local files to the spool directory for transfer. 


-ggrade Grade is a single letter/number; lower ASCII sequence characters 
will cause the job to be transmitted earlier during a particular con- 
versation. 


j Output the jobid ASCII string on the standard output which is the 


job identification. This job identification can be used by uustat to 
obtain the status of a job or to terminate it. 


n Do not notify the user if the command fails. 

-p Same as -. The standard input to uux is made the standard input 
to the commanda-string. 

rr Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer in file. 

-xdebug_level 


Produce debugging output on the standard output. The debug_level 
is a number between 0 and 9; higher numbers give more detailed 
information. 


=z Send success notification to the user. 


/asr/lib/uucp/spool Spool directories 
/usr/lib/uucp/Permissions Remote execution permissions 
/usr/lib/uucp/* Other data and programs 


SEE ALSO 


cut(1), mail(1), uucp(1C), uustat(1C) 


WARNINGS 


BUGS 


Only the first command of a shell pipeline may have a system-name!. All other 
commands are executed on the system of the first command. 


The use of the shell metacharacter * will probably not do what you want it to 
do. The shell tokens << and >> are not implemented. 


The execution of commands on remote systems takes place in an execution 
directory known to the uucp system. All files required for the execution will 
be put into this directory unless they already reside on that machine. There- 
fore, the simple filename (without path or machine reference) must be unique 
within the uux request. The following command will not work: 


uux "aldiff bl/usr/dan/xyz cl/usr/dan/xyz > !xyz.diff" 
The next command will work if diff is a permitted command. 
uux “aldiff al/usr/dan/xyz cl/usr/dan/xyz > !xyz.diff" 


Protected files and files that are in protected directories that are owned by the 
requestor can be sent in commands using uux. However, if the requestor is 
root, and the directory is not searchable by “other,” the request will fail. 
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NAME 


uuxqt — execute remote command requests 


SYNOPSIS 


Aasr/lib/uucp/uuxqt [ -s8 system ] [ -x debug_level ] 


DESCRIPTION 


FILES 


uuxqt is a program that executes remote job requests from remote systems 
generated by the use of the uux command. (mail uses uux for remote mail 
requests). uuxgt searches the spool directories looking for X. files. For each 
X. file, uuxqt checks to see if all the required data files are available and 
accessible and if file commands are permitted for the requesting system. The 
Permissions file is used to validate file accessibility and command execution 
permission. 

There are two environment variables that are set before the uuxqt command 
is executed: 


UU_MACHINE is the machine that sent the job (the previous one). 
UU_USER is the user that sent the job. 


These can be used in writing commands that remote systems can execute to 
provide information, auditing, or restrictions. 


The -x debug_level is a single digit between 0 and 9. Higher numbers give 
more detailed debugging information. 


/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 


SEE ALSO 
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uucp(1C), uustat(1C), uux(1C), mail(1), uucico(1M) 


DYNIX/ptx VAL(1) 


NAME 


val — validate SCCS file 


SYNOPSIS 


val - 
val [-s] [-rSID] [-mname] [-ytype] files 


DESCRIPTION 
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val determines if the specified file is an SCCS file meeting the characteristics 
specified by the optional argument list. Arguments to val may appear in any 
order. The arguments consist of keyletter arguments, which begin with a -, 
and named files. 


val has a special argument, -, which causes reading of the standard input 
until an end-of-file condition is detected. Each line read is independently pro- 
cessed as if it were a command line argument list. 


val generates diagnostic messages on the standard output for each command 
line and file processed, and also returns a single 8-bit code upon exit as 
described below. 


The keyletter arguments are defined as follows. The effects of any keyletter 


_ argument apply independently to each named file on the command line. 


-8 The presence of this argument silences the diagnostic message nor- 
mally generated on the standard output for any error that is 
detected while processing each named file on a given command line. 


-rSID The argument value SID (SCCS Identification String) is an SCCS 
delta number. A check is made to determine if the SID is ambigu- 
ous (for example, r1 is ambiguous because it physically does not 
exist but implies 1.1, 1.2, etc., which may exist) or invalid (for 
example, r1.0 or r1.1.0 are invalid because neither case can exist 
as a valid delta number). If the SZD is valid and not ambiguous, a 
check is made to determine if it actually exists. 


-mname The argument value name is compared with the SCCS %M% key- 
word in file. 


-ytype The argument value type is compared with the SCCS %Y% keyword 
in file. 


The 8-bit code returned by val is a disjunction of the possible errors. That is, 
it can be interpreted as a bit string where (moving from left to right) set bits 
are interpreted as follows: 


bit 0 = missing file argument 
bit 1 = unknown or duplicate keyletter argument 
bit 2 = corrupted SCCS file 
bit 3 = cannot open file or file not SCCS 
bit 4 = SID is invalid or ambiguous 
bit 5 = SID does not exist 
bit 6 = Y%, -y mismatch 
bit 7 = %M%, -m mismatch 
Note that val can process two or more files on a given command line and in 


turn can process multiple command lines (when reading the standard input). 
In these cases, an aggregate code is returned—a logical OR of the codes 
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generated for each command line and file processed. 


SEE ALSO 
admin(1), delta(1), get(1), help(1), prs(1) 


DIAGNOSTICS 
Use help(1) for explanations. 


BUGS 
val can process up to 50 files on a single command line. Any number above 50 


will produce a core dump. 
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DYNIX/ptx vc(1) 


NAME 
@ ve — version control 


SYNOPSIS 
ve [-a] [-t] [-cchar] [~s] [keyword=value ... keyword=value] 


DESCRIPTION 
The ve command copies lines from the standard input to the standard output 
under control of its arguments and control statements encountered in the 
standard input. In the process of performing the copy operation, user declared 
keywords may be replaced by their string value when they appear in plain 
text and/or control statements. 


The copying of lines from the standard input to the standard output is condi- 
tional, based on tests (in control statements) of keyword values specified in 
control statements or as ve command arguments. 


Acontrol statement is a single line beginning with a control character, except 
as modified by the -t keyletter (see below). The default control character is 
colon (:), except as modified by the -c keyletter (see below). Input lines begin- 
ning with a backslash (\) followed by a control character are not control lines 
and are copied to the standard output with the backslash removed. Lines 
beginning with a backslash followed by a non-control character are copied in 
their entirety. 


A keyword contains up to 9 alphanumerics; the first must be alphabetic. A 
value is any ASCII string that can be created with ed(1); a numeric value is an 
© unsigned string of digits. Keyword values cannot contain blanks or tabs. 


Replacement of keywords by values is done whenever a keyword surrounded 
by control characters is encountered on a version control statement. The -a 
keyletter (see below) forces replacement of keywords in all lines of text. An 
uninterpreted control character may be included in a value by preceding it 
with \. Ifa literal \ is desired, then it too must be preceded by \. 


Keyletter Arguments 


-a Forces replacement of keywords surrounded by control characters 
with their assigned value in all text lines and not just in ve state- 
ments. 

+t All characters from the beginning of a line up to and including the 


first tab character are ignored for the purpose of detecting a control 
statement. If one is found, all characters up to and including the tab 
are discarded. 


-cchar Specifies a control character to be used in place of the colon (:). 
6 Silences warning messages (not error) that are normally printed on 
the diagnostic output. 
Version Control] Statements 
:dcl keyword{, .... keyword] 
Used to declare keywords. All keywords must be declared. 


sasg keyword=value 
Used to assign values to keywords. An asg statement overrides the 
@ assignment for the corresponding keyword on the ve command line and 
all previous asg’s for that keyword. Keywords declared but not assigned 
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values have null values. 
aif condition 


rend 
Used to skip lines of the standard input. Ifthe condition is true, all lines 
between the if statement and the matching end statement are copied to 
the standard output. If the condition is false, all intervening lines are 
discarded, including control statements. Note that intervening if state- 
ments and matching end statements are recognized solely for the pur- 
pose of maintaining the proper if-end matching. 


The syntax of a condition is as follows: 


<cond> s=[ "not" ] <or> 

<or> s= <and> | <and> "|" <or> 

<and> <exp> | <exp> "&" <and> 

<exp> "(" <or> ")" | <value> <op> <value> 
<op> ne | Met | Met | MyM 


<value> n= <arbitrary ASCII string> | <numeric string> 
The available operators and their meanings are as follows: 


Equal 

Not equal 

And 

Or 

Greater than 

Less than 

0) Used for logical groupings 

not May only occur immediately after the if, and when present, 
inverts the value of the entire condition 


AV—-eiyi 


The > and < operate only on unsigned integer values (for example, : 012 
> 12 is false). All other operators take strings as arguments (for 
example, : 012 != 12 is true). The precedence of the operators (from 
highest to lowest) is as follows: 


sle>< All of equal precedence 

& 

I: 
Parentheses may be used to alter the order of precedence. 
Values must be separated from operators or parentheses by at least one 
blank or tab. 


Used for keyword replacement on lines that are copied to the standard 
output. The two leading control characters are removed, and keywords 
surrounded by control characters in text are replaced by their value 
before the line is copied to the output file. This action is independent of 
the -a keyletter. 
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NAME 
&} ve — version control 


SYNOPSIS 
ve [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 


DESCRIPTION 
The ve command copies lines from the standard input to the standard output 
under control of its arguments and control statements encountered in the 
standard input. In the process of performing the copy operation, user declared 
keywords may be replaced by their string value when they appear in plain 
text and/or control statements. 


The copying of lines from the standard input to the standard output is condi- 
tional, based on tests (in control statements) of keyword values specified in 
control statements or as ve command arguments. 


Acontrol statement is a single line beginning with a control character, except 
as modified by the -t keyletter (see below). The default control character is 
colon (:), except as modified by the -c keyletter (see below). Input lines begin- 
ning with a backslash (\) followed by a control character are not control lines 
and are copied to the standard output with the backslash removed. Lines 
beginning with a backslash followed by a non-control character are copied in 
their entirety. 


A keyword contains up to 9 alphanumerics; the first must be alphabetic. A 
value is any ASCII string that can be created with ed(1); a numeric value is an 
& unsigned string of digits. Keyword values cannot contain blanks or tabs. 


Replacement of keywords by values is done whenever a keyword surrounded 
by control characters is encountered on a version control statement. The -a 
keyletter (see below) forces replacement of keywords in all lines of text. An 
uninterpreted control character may be included in a value by preceding it 
with \. Ifa literal \ is desired, then it too must be preceded by \. 


Keyletter Arguments 


-a Forces replacement of keywords surrounded by control characters 
with their assigned value in all text lines and not just in ve state- 
ments. 

+t All characters from the beginning of a line up to and including the 


first tab character are ignored for the purpose of detecting a control 
statement. If one is found, all characters up to and including the tab 
are discarded. 


-echar Specifies a control character to be used in place of the colon (:). 
8 Silences warning messages (not error) that are normally printed on 
the diagnostic output. 


Version Control Statements 
:dcl keyword, ..., keyword] 
Used to declare keywords. All keywords must be declared. 


tasg keyword=value 
Used to assign values to keywords. An asg statement overrides the 
© assignment for the corresponding keyword on the ve command line and 
all previous asg’s for that keyword. Keywords declared but not assigned 
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values have null values. 
df condition 


rend 
Used to skip lines of the standard input. If the condition is true, all lines 
between the if statement and the matching end statement are copied to 
the standard output. If the condition is false, all intervening lines are 
discarded, including control statements. Note that intervening if state- 
ments and matching end statements are recognized solely for the pur- 
pose of maintaining the proper if-end matching. 


The syntax of a condition is as follows: 


<cond> s=["not" ] <or> 

<or> <and> | <and> "|" <or> 

<and> n= <exp> | <exp> "&" <and> 

<exp> s="(" <or> ")" | <value> <op> <value> 
<op> wee" | Me" [et | tp" 


<value> s= <arbitrary ASCII string> | <numeric string> 
The available operators and their meanings are as follows: 


= Equal 

l= Not equal 
& And 

| Or 

> Greater than 
< Less than 
( 

n 


) Used for logical groupings 
ot May only occur immediately after the if, and when present, 
inverts the value of the entire condition 


The > and < operate only on unsigned integer values (for example, : 012 
> 12 is false). All other operators take strings as arguments (for 
example, : 012 != 12 is true). The precedence of the operators (from 
highest to lowest) is as follows: 


l=>< All of equal precedence 


Parentheses may be used to alter the order of precedence. 
Values must be separated from operators or parentheses by at least one 
blank or tab. 


Used for keyword replacement on lines that are copied to the standard 
output. The two leading control characters are removed, and keywords 
surrounded by control characters in text are replaced by their value 
before the line is copied to the output file. This action is independent of 
the -a keyletter. 

ton 
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soff Turn on or off keyword replacement on all lines. 


sctl char 
Change the control character to char. 


smsg message 
Print the given message on the diagnostic output. 


err message : 
Print the given message followed by: 


ERROR: err statement on line ... (915) 


on the diagnostic output. ve halts execution and returns an exit code of 
1. 


SEE ALSO 
ed(1), help(1) 


DIAGNOSTICS 
Use help(1) for explanations. 
EXIT CODES: 


0—normal 
1 - any error 
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NAME 


vi — screen-oriented (visual) display editor based on ex 


SYNOPSIS 


vi [+t tag] (-r file] [-L] [-wn] [-R] [-x] [-C] [-c command] file ... 
view [-t tag] [-r file] [-L] [-wn] [-R] [-x] [-C] [-c command] file ... 
vedit [-t tag] [-r file] [-L] [-wn] [-R] [-x] [-C] [-c command] file ... 


DESCRIPTION 


vi (visual) is a display-oriented text editor based on an underlying line editor 
ex(1). It is possible to use the command mode of ex from within vi and vice- 
versa. The visual commands are described on this manual page; how to set 
options (like automatically numbering lines and automatically starting a new 
output line when you type carriage return) and all ex(1) line editor commands 
are described on the ex(1) manual page. 


When using vi, changes you make to the file are reflected in what you see on 
your terminal screen. The position of the cursor on the screen indicates the 
position within the file. 


Invocation Options 
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The following invocation options are interpreted by vi (previously documented 
options are discussed in the NOTES section at the end of this manual page). 
The file argument indicates one or more files to be edited. 


-ttag Edit the file containing the tag and position the editor at its 
definition. 

-r file Edit file after an editor or system crash. (Recovers the version 
of file that was in the buffer when the crash occurred.) 

-L List all files saved as the result of an editor or system crash. 

-wn Set the default window size to n. This is useful when using the 


editor over a slow speed line. 


-R Readonly mode; the readonly flag is set, preventing acciden- 
tal overwriting of the file. 


-x Encryption option; when used, vi simulates the X command of 
ex(1) and prompts the user for a key. This key is used to 
encrypt and decrypt text using the algorithm of erypt(1). The 
X command makes an educated guess to determine whether 
text read in is encrypted. The temporary buffer file is 
encrypted also, using a transformed version of the key typed in 
for the -x option. See the WARNING section and erypt(1). 

—C Encryption option; same as the —x option, except that vi simu- 
lates the C command of ex(1). The C command is like the X 
command of ex(1), except that all text read in is assumed to 
have been encrypted. 


-c command Begin editing by executing the specified editor command 
(usually a search or positioning command). 


The view invocation is the same as vi except the readonly flag is set. The 
vedit invocation is intended for beginners. It is the same as vi except the 
report flag is set to 1, the showmode and novice flags are set, and magic is 
turned off, making vi easier to learn. 
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This version of vi supports multiple instances of a tag in a tags file. Multiple 
tags cause vi to enter a special mode and present a list of tags. The user can 
then scan through the list and select the desired tag using the folloing com- 
mands: 


j move down in the list 

ks move up in the list 

CR accept the displayed tag 

n check next tag file 

ESC abort the tags command 

Other keystrokes will give an error indication. 


vi Modes 
Command Normal and initial mode. Other modes return to command mode 
upon completion. Use Esc (escape) to cancel a partial command. 


Input Entered by setting any of these options: aAiloOcCsSR. Arbi- 
trary text may then be entered. Input mode is terminated nor- 
mally with an Esc character; abnormally with an interrupt. 

Last line Reading input for :/? or !; terminate by typing a carriage return;. 
an interrupt cancels termination. 


Command Summary 
Return stands for carriage return and Esc stands for the escape key. 


Sample Commands 


elt Arrow keys move the cursor 

hjkl Same as arrow keys 

itext Esc Insert text 

cwnew Esc Change word to new 

eas Esc Pluralize word (end of word; append s; 
escape from input state) 

x : Delete a character 

dw Delete a word 

dd Delete a line 

3dd Delete 3 lines 

u Undo previous change 

ZZ Exit vi, saving changes 

:q! Return Quit, discarding changes 

itext Return Search for text 

Ctrl-U, Ctrl-D Scroll up or down 

temd Return Any ex or ed command 
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Counts Before vi Commands 


VI(1) . 


Numbers may be typed as a prefix to some commands. They are interpreted in 


one of these ways: 


Line/column number 2 G | 
Scroll amount Ctrl-D Ctrl-U 
Repeat effect most of the rest 
Interrupting, Canceling 
Esc End insert or incomplete cmd 
Delete (Delete or rubout) interrupts 
File Manipulation 
ZZ If file modified, write and exit; else exit 
:w Return Write back changes 
:w! Return Forced write, if permission originally not valid 
:q Return Quit 
:q! Return Quit, discard changes 
:e name Return Edit file name 
:e! Return Reedit, discard changes 
te + name Return Edit, starting at end 
:e +n Return Edit starting at line n 
:e # Return Edit alternate file 
:e! # Return Edit alternate file, discard changes 


:w name Return 
tw! name Return 
:sh Return 
:!emd Return 

tn Return 

:n args Return 
Ctrl-G 

sta tag Return 


Write file name 
Overwrite file name 

Run shell, then return 
Run cmd, then return 
Edit next file in arglist 
Specify new arglist 

Show current file and line 
Position cursor to tag 


In general, any ex or ed command (such as substitute or global) may be 
typed, preceded by a colon and followed by a carriage return. 


Positioning Within File 

Ctrl-F Forward screen 

Ctrl-B Backward screen 

Ctrl-D Scroll down half screen 

Ctrl-U Scroll up half screen 

nG Go to the beginning of the specified line 

(end default), where n is a line number 

Ipat Next line matching pat 

2pat Previous line matching pat 

n Repeat last / or ? command 

N- Reverse last / or ? command 

Ipatl+n nth line after pat 
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?pat?-n nth line before pat 
I Next section/function 
if Previous section/function 
( Beginning of sentence 
) End of sentence 
{ Beginning of paragraph 
} End of paragraph 
% Find matching () { or} 
Adjusting the Screen 
Ctrl-L Clear and redraw window 
Ctrl-R Clear and redraw window if Lis > key 
z Return Redraw screen with current line at window top 
z~ Return Redraw screen with current line at window bottom 
z. Return Redraw screen with current line at window center 
/patiz— Return Move pat line to bottom of window 
zn, Return Use n-line window 
Ctrl-E Scroll window down 1 line 
Ctrl-Y Scroll window up 1 line 
Marking and Returning 
as Move cursor to previous context 
ae Move cursor to first non-white space in line 
mx Mark current position with the ASCII lowercase letter x 
“x Move cursor to mark x 
“x Move cursor to first non-white space in line marked by x 
Line Positioning 
H Top line on screen 
L Last line on screen 
M Middle line on screen 
+ Next line, at first non-white 
- Previous line, at first non-white 
Return Return, same as + 
Lorj Next line, same column 
Tork Previous line, same column 
Character Positioning 
. First non white-space character 
0 Beginning of line 
$ End of line 
hor Forward 
lore Backward 
Ctrl-H Same as <— (backspace) 
space Same as —> (space bar) 
fx Find next x 
Fx Find previous x 
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n| 
% 


Move to character prior to next x 
Move to character following previous x 
Repeat last f F t or T 

Repeat inverse of last f F t or T 

Move to column n 

Find matching ( {) or} 


Words, Sentences, Paragraphs 


w Forward a word 
b Back a word 
e End of word 
) To next sentence 
} To next paragraph 
( Back a sentence 
{ Back a paragraph 
Ww Forward a blank-delimited word 
B Back a blank-delimited word 
E End of a blank-delimited word 
Corrections During Insert 
Ctrl-H Erase last character (backspace) 
Ctrl-W Erase last word 
Erase Your erase character, same as Ctrl-H (backspace) 
Kill Your kill character, erase this line of input 
\ Quotes your erase and kill characters 
Esc Ends insertion, back to command mode 
Del Interrupt, terminates insert mode 
Ctrl-D Backtab one character; reset left margin 
of autoindent 
“Ctrl-D Caret (*) followed by Ctrl-D; 
backtab to beginning of line; 
do not reset left margin of autoindent 
0Ctrl-D Backtab to beginning of line; 
reset left margin of autoindent 
Ctrl-V Quote non-printable character 
Insert and Replace 
a Append after cursor 
A Append at end of line 
i Insert before cursor 
I Insert before first non-blank 
i) Open line below 
oO Open line above 
rx Replace single char with x 
Rtext Esc Replace characters 
Operators 
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Operators are followed by a cursor motion and affect all text that would have 
been moved. For example, since w moves over a word, dw deletes the word 
that would be moved over. Double the operator (e.g., dd) to affect whole lines. 
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Delete 

Change 

Yank lines to buffer 

Left shift 

Right shift 

Filter through command 


"VAM OB 


Miscellaneous Operations 


Change rest of line (c$) 

Delete rest of line (d$) 

Substitute characters (cl) 
Substitute lines (ec) 

Join lines 

Delete characters (dl) 

Delete characters before cursor (dh) 
Yank lines (yy) 


Yank and Put 


Put inserts the text most recently deleted or yanked; however, if a buffer is 
named (using the ASCII lowercase letters a - z), the text in that buffer is put 


KX ONE OO 


instead. 

3yy Yank 3 lines 

3yl Yank 3 characters 

) Put back text after cursor 

P Put back text before cursor 

"xp Put from buffer x 

"xy Yank to buffer x 

"xd Delete into buffer x 
Undo, Redo, Retrieve 

u Undo last change 

U Restore current line 

c Repeat last change 

"dp Retrieve d’th last delete 

AUTHOR 


vi and ex were developed by The University of California, Berkeley California, 
Computer Science Division, Department of Electrical Engineering and Com- 
puter Science. 


FILES 
/tmp Default directory where temporary work files are 
placed; it can be changed using the directory option 
(see the ex(1) set command) 
/usr/lib/terminfo/?/+ | Compiled terminal description database 


SEE ALSO 
ed(1), edit(1), ex(1) 


WARNINGS 
The encryption options are available only in the United States. 
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Tampering with entries in /usr/lib/terminfo/?/* (for example, changing or 
removing an entry) can affect programs such as vi(1) that expect the entry to 
be present and correct. In particular, removing the “dumb" terminal may 
cause unexpected problems. 

NOTES 
Two options, although they continue to be supported, have been replaced in 
the documentation by options that follow the Command Syntax Standard (see 
intro(1)). A-r option that is not followed with an option-argument has been 
replaced by -L and +command has been replaced by -c command. 

BUGS 
Software tabs using Ctrl-T work only immediately after the autoindent. 
Left and right shifts on intelligent terminals do not make use of insert and 
delete character operations in the terminal. 
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NAME 


vmtune — tune system-wide virtual-memory parameters 


SYNOPSIS 


/etc/vmtune [ -f ] [ options ] 


DESCRIPTION 
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vmtune provides a programmatic interface to the vm_ctl(2) system call, 
allowing display and tuning of system-wide virtual-memory parameters. With 
no arguments, vmtune prints the current contents of the vmtune structure 
in the kernel, which holds the tuning parameters. The decimal value of each 
field is printed next to the name of the field. All memory sizes are displayed 
and entered in Kbytes. 


Options allow the modification of the parameters, either individually or as a 
group. Only the superuser may alter the setting of the parameters. Options 
come in both a short form (easy to type) and ine form (easy to remember). 
Available options are as follows: 


-r minRS 
-minRS minRS 
Minimum size of a process resident-set, in Kbytes. This value is 
silently enforced to be at least two, and limited by maxRS. 


-R maxRS 

-maxRS maxRS 
Maximum size of a process resident-set, in Kbytes. This value is 
silently enforced to be at least two, and limited by a boot-time deter- 
mined value that insures the resident-set can fit in physical memory. 


-e RSexecslop 
-RSexecslop RSexecslop 
See RSexecdiv below. 


-m RSexecmult 
-RSexecmult RSexecmult 
See RSexecdiv below. 


~-d RSexecdiv 
-RSexecdiv RSexecdiv 
The exec(2) system call determines the initial resident-set size of a 
process via: 
((text + data + bss) * RSexecmult) / RSexecdiv + RSexecslop 


where RSexecmult / RSexecdiv provides a rational fraction 
and all other values are in Kbytes. 

-Ldirtylow 

-dirtylow dirtylow 
Minimum size of the dirty-memory list, in Kbytes. 

-H dirtyhigh 

-dirtyhigh dirtyhigh 
Maximum size of the dirty-memory list, in Kbytes. When the size of 
the dirty-list exceeds this, a system process begins writing pages to 
swap-space. Once this process starts, it won’t stop until the size of the 
dirty-list is within the maximum pageout-size of dirtylow. The 
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maximum pageout size is currently 16 Kbytes. 


-K klout_look 

-klout_look klout_look 
When the pageout process runs, it attempts to locate dirty pages that 
live in adjacent blocks on the swap device(s) to write with one opera- 
tion (to minimize the number of I/O requests). klout_look specifies 
how deep into the dirty-list it will look (in kernel pages). A value of 
zero disables clustered pageouts. 


-v PFFvtime 

-PFFvtime PFFvtime 
The number of clock ticks (10ms) of process virtual time between calls 
to the page-fault frequency algorithm. If zero, page-fault frequency 
adjustment of all processes is disabled. If non-zero, when the interval 
elapses the system normalizes the number of page-faults the process 
has taken to number of faults per second, and may adjust the resident- 
set size of the process up or down depending on the rate. This adjust- 
ment takes place on a per-process basis. 


-D PFFdecr 

-PFFdecr PFFdecr 
The number of Kbytes to reduce the resident-set of the process if its 
page-fault rate is below PFFlow. . 


-1 PFFlow 
-PFFlow PFFlow 
Page-fault frequency lower-limit (page-faults per second). 


-I PFFincr 

-PFFincr PFFincr 
The number of Kbytes to increase the resident-set of the process if its 
page-fault rate is above PFFhigh. 


-h PFFhigh 
-PFFhigh PFFhigh 
Page-fault frequency upper-limit (page-faults per second). 


-8 minfree 

-minfree minfree 
The lower-bound on average free memory (in Kbytes) before the 
swapper gets more aggressive about swapping out processes. 


-S desfree 

-desfree desfree 
The swapper wants this much memory (in Kbytes) to be free on the 
average. 

-M maxdirty 

-maxdirty maxdirty 
If the average size of the dirty-list (in Kbytes), the swapper becomes 
equally as aggressive as in the minfree case. 


The operating system kernel does some sanity checking on the altered values, 
but improper or naive settings can adversely affect the performance and other 
behavior of the system. Because of this, vmtune normally dumps the values 
and asks for verification of the change. The -f flag forces the change with no 
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verification query. 
@ SEE ALSO 
getpagesize(2), vm_ctl(2) 


BUGS 
There should be guidelines on why, when, and how to alter these parameters. 


Naive setting of the parameters can adversely affect system performance. 
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NAME 


voleopy — make literal copy of filesystem 


SYNOPSIS 


/etc/voleopy [ options ] filesystem from_dev from_vol to_dev to_vol 


DESCRIPTION 
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volcopy makes a literal copy of the filesystem using a blocksize matched to 
the device. The following arguments are required: 


filesystem _ filesystem is the mounted filesystem name (for example root 
or u1) of the filesystem being copied. 


from_dev The from_dev is the physical disk section or tape (such as 
/dev/rdsk/zd0s2, {dev /rmt/xt0) which is being copied. 


from_vol The from_vol is the physical volume name (such as pk5, 
tp123) from which the information is being read and should 
match the external label sticker. Label names are limited to 
six characters. from_vol may be — to use the existing volume 
name. 


to_dev The to_dev is the physical disk section or tape (such as 


/dev/rdsk/zd0s2, /dev/rmt/xt0) which is being written on. 


to_vol The to_vol is the physical volume name (such as pk6, or 
tp123) to which the information is being written and should 
match the external label sticker. Label names are limited to 
six characters. to_vol may be — to use the existing volume 
name. 


The following flag arguments are optional: 
-feet tapelength 
Specifies the length of the tape in feet. 


~bpidensity Specifies the tape density in BPI. Only 800, 1600 and 6250 are 
allowed. 


-reel reel_number 
Specifies the reel number if not starting at the first reel. 


-buf Specifies double buffering if the density is greater than or 
equal to 1600 bpi. 

-a Invokes a verification sequence requiring a positive operator 
response instead of the standard 10 second delay before the 
copy is made 

-s Invokes the DEL if wrong verification sequence. This is the 
default. 

-y Assumes that the response to all questions is yes. 


The program requests length and density information if it is not given on the 
command line or is not recorded on an input tape label. If the filesystem is too 
large to fit on one reel, volcopy prompts for additional reels. Labels of all 
reels are checked. Tapes may be mounted alternately on two or more drives. 
If voleopy is interrupted, it asks if the user wants to quit or wants a shell. In 
the latter case, the user can perform other operations (for example, labelit) 
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and return to voleopy by exiting the new shell. 


If the file /etc/log/filesave.log exists, voleopy will write a dated entry to show 
the backup history of copied volumes. If the file does not exist, a warning is 
generated. 
In summary, from_dev and from_vol are the device and volume from which 
the copy of the filesystem is being extracted. to_dev and to_vol are the tar- 
get device and volume. 

EXAMPLES 
In the following example, the rvot filesystem is being copied from one disk to 
another: 


volcopy root /dev/rdsk/zd0s0 pk5 /dev/rdsk/zdl1s2 pk12 


In this example, the u3 filesystem is being copied from a disk to a 2400 foot 
magnetic tape at 3250 bpi: 


volcopy -feet 2400 -bpi 6250 u3 /dev/rdsk/sd1s3 pkl \ 
/dev/rmt/xt0 tp123 


In the following example, a disk is being restored from a magnetic tape. Using 
a hyphen for the to and from volume names tells voleopy to use the label that 
is already on the tape. 


volcopy u5 /dev/rmt/xt0 - /dev/rdsk/zdis3 — 


FILES 
Jetc/log/filesave.log Arecord of filesystems/volumes copied 


SEE ALSO 
sh(1), labelit(1M) 

WARNINGS 
voleopy does not support tape-to-tape copying. Use dd(1) for tape-to-tape 
copying. 
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NAME 
vsig — synchronize a co-process with the controlling FMLI object 
SYNOPSIS 
vsig 
DESCRIPTION ‘ 
The vsig executable sends a SIGUSR2 signal to the controlling FMLI process. 
This signal causes FMLI to execute the FMLI command checkworld, causing 
all displayed objects with a reread descriptor evaluating to TRUE to be 
reread. 
EXAMPLES 
The following is a segment of a shell program: 
echo "Sending this string to an FMLI process" 
vsig 
The vsig command flushes the output buffer before it sends the SIGUSR2 sig- 
nal to make sure the string is actually in the pipe created by the cocreate 
built-in. 
SEE ALSO 
coproc(1F), signal(2) 
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NAME 
wait — await completion of process 


SYNOPSIS 
wait [nr ] 


DESCRIPTION 
Wait for your background process having process ID n and report its termina- 
tion status. Ifn is omitted, all your shell’s currently active background 
processes are waited for and the return code will be zero. 


The shell itself executes wait without creating a new process. 


SEE ALSO 
sh(1), ksh(1), csh(1) 


DIAGNOSTICS 
If you receive the error message cannot fork, too many processes , try using the 
wait(1) command to clean up your background processes. If this doesn’t help, 
the system process table is probably full or you have too many active fore- 
ground processes. (There is a limit to the number of process IDs associated 
with your login and to the number the system can track.) 


BUGS 
Not all processes of a 3- or more-stage pipeline are children of the shell, and 
thus cannot be waited for. 


If n is not an active process ID, all your shell’s currently active background 
processes are waited for and the return code will be zero. 
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NAME 
wall — write to all users 


SYNOPSIS 
/etc/wall 


DESCRIPTION 
wall reads its standard input until an end-of-file. It then sends the message 
to all currently logged-in users preceded by the following line: 


Broadcast Message from... 
It is used to warn all users, typically prior to shutting down the system. 


The sender must be superuser to override any protections the users may have 
invoked (see mesg(1)). 


FILES 
/devitty* 


SEE ALSO 
mesg(1), write(1) 


DIAGNOSTICS 
Cannot send to... The open on a user’s tty file failed. 
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NAME 
we — word count 
SYNOPSIS 
we [ -lwe ] [ names ] 
DESCRIPTION 
we counts lines, words, and characters in the named files, or in the standard 


input if no names appear. It also keeps a total count for all named files. A 
word is a maximal string of characters delimited by spaces, tabs, or newlines. 


The options 1, w, and c may be used in any combination to specify that a sub- 
set of lines, words, and characters are to be reported. The default is -lwe. 


When names are specified on the command line, they will be printed along 
with the counts. 
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NAME 
what — identify SCCS files 


SYNOPSIS 
what [-s] files 


DESCRIPTION 
what searches the given files for all occurrences of the pattern that get(1) 
substitutes for %Z% (this is @(#) at this printing) and prints out what follows 
until the first ", >, newline, \, or null character. For example, if the C pro- 
gram in file fc contains this line: 


#ident "@(#)identification information" 
and fc is compiled to yield fo and a.out, then the command 
what f.c f.o a.out 


will print the following: 


fie: 

identification information 
fio: 

identification information 
a.out: 


identification information 


what is intended to be used in conjunction with the command get(1), which 
automatically inserts identifying information, but it can also be used where 
the information is inserted manually. Only one option exists: 

-8 Quit after finding the first occurrence of pattern in each file. 


SEE ALSO 
get(1), help(1) 

DIAGNOSTICS 
Exit status is 0 if any matches are found, otherwise 1. Use help(1) for expla- 
nations. 

BUGS 
It is possible that an unintended occurrence of the pattern @(#) could be found 
just by chance, but this causes no harm in nearly all cases. 
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NAME 
whatis — describe what a command is 


SYNOPSIS 
whatis command ... 


DESCRIPTION 
whatis looks up a command and displays the header line from the manual 
section. You can then run the man(1) command to get more information. If 


the line starts name (section) ..., enter man section name to get the 
documentation for it. For example, you can enter whatis ed and then man 1 
ed to get the manual page. 
whatis is equivalent to the man -f command. 

FILES 
/usr/catman/whatis Data base 

SEE ALSO 


man(1), apropos(1), makewhatis(1M) 
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NAME 


who — who is on the system 


SYNOPSIS 


who [-uTlHqpdbrtas] [-n x] [ file ] 
who am i 


who am I 


DESCRIPTION 
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who can list the user’s name, terminal line, login time, elapsed time since 
activity occurred on the line, and the process-ID of the command interpreter 
(shell) for each current user. It examines the /etc/utmp file at login time to 
obtain its information. If file is given, that file (which must be in utmp(4) for- 
mat) is examined. Usually, file will be /etc/wtmp, which contains a history of 
all the logins since the file was last created. 


who with the am i or am I option identifies the invoking user. 
The general format for output is as follows: 
name [state] line time [idle] [pid] [comment] [exit] 


The name, line, and time information is produced by all options except -q; the 
state information is produced only by ~T; the idle and pid information is pro- 
duced only by -u and -1; and the comment and exit information is produced 
only by -a. The information produced for -p, -d, and -r is explained during 
the discussion of each option, below. 


With options, who can list logins, logoffs, reboots, and changes to the system 
clock, as well as other processes spawned by the init process. These options 
are as follows: 


-u This option lists only those users who are currently logged in. The 
name is the user’s login name. The line is the name of the line as found 
in the directory /dev. The time is the time that the user loggedin. The 
idle column contains the number of hours and minutes since activity 
last occurred on that particular line. A dot (.) indicates that the termi- 
nal has seen activity in the last minute and is therefore “current”. If 
more than 24 hours have elapsed or the line has not been used since 
boot time, the entry is marked old. This field is useful when trying to 
determine whether a person is working at the terminal. The pid is the 
process-ID of the user’s shell. The comment is the comment field associ- 
ated with this line as found in /etc/inittab (see inittab(4)). This can 
contain information about where the terminal is located, the telephone 
number of the dataset, type of terminal if hard-wired, etc. 


-T This option is the same as the -s option, except that the state of the ter- 
minal line is printed. The state describes whether someone else can 
write to that terminal. A + appears if the terminal is writable by any- 
one; a — appears if it is not. root can write to all lines having a + or a— 
in the state field. If a bad line is encountered, a ? is printed. 

-l This option lists only those lines on which the system is waiting for 
someone to login. The name field is LOGIN in such cases. Other fields 
are the same as for user entries except that the state field does not 
exist. 
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-H = This option will print column headings above the regular output. 


-q = This is a quick who, displaying only the names and the number of users 
currently logged on. When this option is used, all other options are 
ignored. 


=p _ This option lists any other process which is currently active and has 
been previously spawned by init. The name field is the name of the pro- 
gram executed by init as found in /etc/inittab. The state, line, and idle 
fields have no meaning. The comment field shows the id field of the line 
from /etc/inittab that spawned this process. See inittab(4). 


-d = This option displays all processes that have expired and not been 
respawned by init. The exit field appears for dead processes and con- 
tains the termination and exit values (as returned by wait(2)), of the 
dead process. This can be useful in determining why a process ter- 
minated. 


-b This option indicates the time and date of the last reboot. 


-r _ This option indicates the current run-level of the init process. In addi- 
tion, it produces the process termination status, process id, and process 
exit status (see utmp(4)) under the idle, pid, and comment headings, 
respectively. 


-t This option indicates the last change to the system clock (via the 
date(1) command) by root. See su(1). 


-a _ This option processes /etc/utmp or the named file with all options 
turned on. 


-s This option is the default and lists only the name, line, and time fields. 


-nx This option takes a numeric argument, x, which specifies the number of 
users to display per line. x must be at least L The -n option must be 
used with —q. 


Note to the superuser: after a shutdown to the single-user state, who returns 
a prompt; the reason is that since /etc/utmp is updated at login time and 
there is no login in single-user state, who cannot report accurately on this 
state. who am i, however, returns the correct information. 


FILES 
/etc/utmp 
/etc/wtmp 
/etc/inittab 
SEE ALSO 
date(1), login(1), mesg(1), init(1M), su(1M), wait(2), inittab(4), utmp(4) 
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NAME 
whodo — who is doing what 


SYNOPSIS 
lete/whodo 


DESCRIPTION 
whodo produces formatted and dated output from information in the 
/etc/utmp and /etc/ps_date files. 


The display is headed by the date, time and machine name. For each user 
logged in, device name, user-id and login time is shown, followed by a list of 
active processes associated with the user-id. The list includes the device name, 
process-id, cpu minutes and seconds used, and process name. 


EXAMPLES 
The command: 


whodo 
produces a display like this: 


Fri Jun 9 17:52:14 1989 
e1m229 


syscon root 17:50 
syscon 13303 0:00 sh 


ttyGA/GAAB dale 8:27 
ttyGA/GAAB 29083 0:05 ksh 
ttyGA/GAAB 15194 0:00 vi 
ttyGA/GAAB 15196 0:00 whodo 


ttyGA/GAAF joe 14:59 
ttyGA/GAAF 12669 0:00 ksh 
ttyGA/GAAF 12797 0:12 ksh 
ttyGA/GAAF 15169 0:01 menu 


FILES 
etc/passwd 
/etc/ps_data 
/etc/utmp 


SEE ALSO 
ps(1), who(1) 
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NAME 
write — write to another user 


SYNOPSIS 
write user [ line ] 


DESCRIPTION ° 
write copies lines from your terminal to that of another user. When first 
called, it sends the following message to the person you want to talk to: 


Message fromyourname (tty??/????) [date] 


When it has successfully completed the connection, it also sends two bells to 
your own terminal to indicate that what you are typing is being sent. 


The recipient of the message should write back at this point. Communication 
continues until an end of file is read from the terminal, an interrupt is sent, or 
the recipient has executed mesg n. At that point write writes EOT on the 
other terminal and exits. 


If you want to write to a user who is logged in more than once, the line argu- 
ment may be used to indicate which line or terminal to send to (such as 
ttyGA/AAAA). Otherwise, the first writable instance of the user found in 
/etc/utmp is assumed and the following message is posted: 


user is logged on more than one place. 
You are connected to "terminal". 

Other locations are: 

terminal 


Permission to write may be denied or granted by use of the mesg(1) command. 
Writing to others is normally allowed by default. Certain commands such as 
pr(1) disallow messages in order to prevent interference with their output. 
However, if the user has superuser permissions, messages can be forced onto a 
write-inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell to 
execute the rest of the line as a command. 


The following protocol is suggested for using write: when you first write to 
another user, wait for them to write back before starting to send. Each per- 
son should end a message with a distinctive signal (such as (0) for “over”) so 
that the other person knows when to reply. The signal (oo) (for “over and 
out”) is suggested when conversation is to be terminated. 


FILES 
/etc/utmp To find user 
/oin/sh To execute ! 
SEE ALSO 
mail(1), mesg(1), pr(1), sh(1), who(1) 
DIAGNOSTICS 


user is not logged on 
The person you are trying to write to is not logged on. 

Permission denied 
The person you are trying to write to denies that permission (with 
mesg). 
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Your terminal is set to mesg'n and the recipient cannot respond to 
you. 

Can no longer write to user 
The recipient denied permission (mesg n) after you started writing. 


Warning: cannot respond, set mesg —y 


2 12/89 


DYNIX/ptx XARGS(1) 


NAME 


xargs — construct argument list(s) and execute command 


SYNOPSIS 


xargs [flags] [ command [initial-arguments] ] 


DESCRIPTION 
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xargs combines the fixed initial-arguments with arguments read from stan- 
dard input to execute the specified command one or more times. The number 
of arguments read for each command invocation and the manner in which 
they are combined are determined by the flags specified. 


command, which may be a shell file, is searched for by using one’s $PATH. If 
command is omitted, /bin/echo is used. 


Arguments read in from standard input are defined to be contiguous strings of 
characters delimited by one or more blanks, tabs, or newlines; empty lines are 
always discarded. Blanks and tabs may be embedded as part of an argument 
if escaped or quoted. Characters enclosed in quotes (single or double) are 
taken literally, and the delimiting quotes are removed. Outside of quoted 
strings, a backslash (\) will escape the next character. 


Each argument list is constructed starting with the initial-arguments followed 
by some number of arguments read from standard input (Exception: see -i 
flag). Flags -i, -1, and -n determine how arguments are selected for each com- 
mand invocation. When none of these flags are coded, the initial-arguments 
are followed by arguments read continuously from standard input until an 
internal buffer is full. Then command is executed with the accumulated args. 
This process is repeated until there are no more args. When there are flag 
conflicts (for example, -l vs. -n), the last flag has precedence. 


Flag values are as follows: 


-lnumber command is executed for each non-empty number lines of argu- 
ments from standard input. The last invocation of command will 
be with fewer lines of arguments if fewer than number remain. 
Aline is considered to end with the first newline unless the last 
character of the line is a blank or a tab. A trailing blank/tab sig- 
nals continuation through the next non-empty line. If number is 
omitted, 1 is assumed. Option -x is forced. 


-ireplstr Insert mode: command is executed for each line from standard 
input, taking the entire line as a single arg, inserting it in initial- 
arguments for each occurrence of replstr. A maximum of 5 argu- 
ments in initial-arguments may each contain one or more 
instances of replstr. Blanks and tabs at the beginning of each 
line are thrown away. Constructed arguments may not grow 
larger than 255 characters, and option —x is also forced. {} is 
assumed for replstr if not specified. 


-nnumber Execute command using as many standard input arguments as 
possible, up to number arguments maximum. Fewer arguments 
will be used if their total size is greater than size characters, and 
for the last invocation if there are fewer than number arguments 
remaining. If option -x is also coded, each number arguments 
must fit in the size limitation, else xargs terminates execution. 
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+t Trace mode: The command and each constructed argument list 
are echoed to file descriptor 2 just prior to their execution. 


-p Prompt mode: The user is asked whether to execute command 
each invocation. Trace mode (-t) is turned on to print the com- 
mand instance to be executed, followed by a ?... prompt. A reply 
of y (optionally followed by anything) will execute the command; 
anything else, including just a carriage return, skips that partic- 
ular invocation of command. 


-x Causes xargs to terminate if any argument list would be greater 
than size characters; -x is forced by the options -i and-l. When 
none of the options -i, -1, or -n are coded, the total length of all 
arguments must be within the size limit. 


—ssize The maximum total size of each argument list is set to size char- 
acters; size must be a positive integer less than or equal to 470. If 
-s is not coded, 470 is taken as the default. Note that the charac- 
ter count for size includes one extra character for each argument 
and the count of characters in the command name. 


-eeofstr eofstr is taken as the logical end-of-file string. Underbar (_) is 
assumed for the logical EOF string if -e is not coded. The value 
-e with no eofstr coded turns off the logical EOF string capability 
(underbar is taken literally). xargs reads standard input until 
either end-of-file or the logical EOF string is encountered. 


xargs will terminate if it receives a return code of -1 from, or ifit cannot exe- 

cute, command. When command is a shell program, it should explicitly exit 

(see sh(1)) with an appropriate value to avoid accidentally returning with -L 
EXAMPLES 


The following example moves all files from directory $1 to directory $2 and 
echos each move command just before doing it: 


ls $1 | xargs -i -t mv $1/{} $2/{} 


The following example combines the output of the parenthesized commands 
onto one line, which is-then echoed to the end of file log: 

(logname; date; echo $0 $*) | xargs >>log 
The user is asked which files in the current directory are to be archived and 


archives them into arch one at a time (example 1), or many at a time (example 
2). 


Example1) ls | xargs -p -1l ar r arch 

Example2) ls | xargs -p -l1 | xargs ar r arch 
The following example executes diff(1) with successive pairs of arguments 
originally typed as shell arguments: 

echo $* | xargs -n2 diff 


SEE ALSO 
sh(1) 
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NAME 
yacc — yet another compiler-compiler 


SYNOPSIS 
yacc [ -vdl]t ] grammar 


DESCRIPTION 
The yace command converts a context-free grammar into a set of tables for a 
simple automaton which executes an LR(1) parsing algorithm. The grammar 
may be ambiguous; specified precedence rules are used to break ambiguities. 


The output file, y.tab.c, must be compiled by the C compiler to produce a pro- 
gram yyparse. This program must be loaded with the lexical analyzer pro- 
gram, yylex, as well as main and yyerror, an error handling routine. These 
routines must be supplied by the user; lex(1) is useful for creating lexical 
analyzers usable by yacc. 


If the -v flag is given, the file y.output is created containing a description of 
the parsing tables and a report on conflicts generated by grammar ambigui- 
ties. 


If the -d flag is used, the file y.tab.h is generated with the #define statements 
that associate the yacc-assigned “token codes” with the user-declared “token 
names”. This allows source files other than y.tab.c to access the token codes. 


If the -I flag is given, the code produced in y.tab.c does not contain any #line 
constructs. This should only be used after the grammar and the associated 
actions are fully debugged. 


Runtime debugging code is always generated in y.tab.c under conditional com- 
pilation control. By default, this code is not included when y.tab.c is compiled. 
However, when yacc’s -t option is used, this debugging code is compiled by 
default. Independent of whether the -t option was used, the runtime debug- 
ging code is under the control of YYDEBUG, a preprocessor symbol. If YYDE- 
BUG has a non-zero value, debugging code is included. If its value is zero, the 
code is not included. The size and execution time of a program produced with- 
out the runtime debugging code is smaller and slightly faster. 


FILES 
y.output 
y.tab.c 
y.tab.h Defines for token names 
yacc.tmp, yacc.debug, yacc.acts Temporary files 
/usr/lib/yaccpar Parser prototype for C programs 
SEE ALSO 
lex(1) 
DIAGNOSTICS 
The number of reduce-reduce and shift-reduce conflicts is reported on stan- 
dard error; a more detailed report is found in the y.output file. Similarly, if 
some rules are not reachable from the start symbol, this is also reported. 
WARNINGS 
Because filenames are fixed, at most one yacc process can be active in a given 
directory at a given time. 
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